. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 与 Web 框架集成需要完成两部分配置：托管 PyWebIO 前端静态文件；暴露 PyWebIO 后端接口。这其中需 要注意前端页面和后端接口的路径约定，以及前端静态文件与后端接口分开部署时因为跨域而需要的特别设 置。 22 Chapter 4. Documentation PyWebIO, 发布 1.0.3 集成方法 不同 Web 框架的集成方法如下： Tornado Flask

Release notes What’s new in PyWebIO 1.0 What’s new in PyWebIO 0.3 What’s new in PyWebIO 0.2 实现文档 服务器-客户端通信协议 Command Event Indices and tables 索引 模块索引 搜索页面 Discussion and support Need help when use PyWebIO tp Web框架的 集成。 与Web框架集成需要完成两部分配置：托管PyWebIO前端静态文件；暴露 PyWebIO后端接口。这其中需要注意前端页面和后端接口的路径约定， 以及前 端静态文件与后端接口分开部署时因为跨域而需要的特别设置。 集成方法 不同Web框架的集成方法如下： Tornado Flask Django aioh�p 需要在Tornado应用中引入两个 RequestHandler ，需要在 页面上通过 pywebio_api 参数传入后端API地址，并且将 https://wang0618.github.io 加入 allowed_origins 列表中（见下文”跨域配 置”说明）。 跨域配置 当后端API与前端页面不在同一host下时，需要在 webio_handler() 或 webio_view() 中使用 allowed_origins 或 check_origin

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 此部分内容属于高级特性，您不必使用此部分也可以实现 PyWebIO 支持的全部功能。PyWebIO 中所有仅用 于协程会话的函数或方法都在文档中有特别说明。 PyWebIO 的会话实现默认是基于线程的，用户每打开一个和服务端的会话连接，PyWebIO 会启动一个线程来 运行任务函数。除了基于线程的会话，PyWebIO 还提供了基于协程的会话。基于协程的会话接受协程函数作 为任务函数。 4.1. User’s guide

PyWebIO 1.1 What’s new in PyWebIO 1.0 What’s new in PyWebIO 0.3 What’s new in PyWebIO 0.2 实现文档 服务器-客户端通信协议 Command Event Indices and tables 索引 模块索引 搜索页面 Discussion and support Need help when use PyWebIO 此部分内容属于高级特性，您不必使用此部分也可以实现PyWebIO支持的全部 功能。PyWebIO中所有仅用于协程会话的函数或方法都在文档中有特别说明。 PyWebIO的会话实现默认是基于线程的，用户每打开一个和服务端的会话连 接，PyWebIO会启动一个线程来运行任务函数。 除了基于线程的会话， PyWebIO还提供了基于协程的会话。基于协程的会话接受协程函数作为任务函 数。 基于协程的会话为单线程模型，所有会话都运行在一个线程内。对于IO密集型 put_row 使用行布局输出内容 put_column 使用列布局输出内容 put_grid 使用网格布局输出内容 span 在 put_table() 和 put_grid() 中设置内容跨单元 格 style 自定义输出内容的css样式 其他 output 内容占位符 输出域Scope pywebio.output.set_scope(name, container_scope=-

PyWebIO 1.1 What’s new in PyWebIO 1.0 What’s new in PyWebIO 0.3 What’s new in PyWebIO 0.2 实现文档 服务器-客户端通信协议 Command Event Indices and tables 索引 模块索引 搜索页面 Discussion and support Need help when use PyWebIO 使用 path_deploy() 可以从一个路径中部署PyWebIO应用。位于该路径下的 python文件需要包含名字为 main 的PyWebIO任务函数才能被视为PyWebIO应用 程序。服务端会根据用户访问的URL来确定需要加载的文件并从中读取 PyWebIO应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py └── c 关于协程内容属于高级特性，您不必使用此部分也可以实现PyWebIO支持的全 部功能。PyWebIO中所有仅用于协程会话的函数或方法都在文档中有特别说 明。 PyWebIO的会话实现默认是基于线程的，用户每打开一个和服务端的会话连 接，PyWebIO会启动一个线程来运行任务函数。 除了基于线程的会话， 启动aiohttp应用后，访问 http://localhost/tool 即可打开PyWebIO应用 注意 当

PyWebIO 1.1 What’s new in PyWebIO 1.0 What’s new in PyWebIO 0.3 What’s new in PyWebIO 0.2 实现文档 服务器-客户端通信协议 Command Event Indices and tables 索引 模块索引 搜索页面 Discussion and support Need help when use PyWebIO 使用 path_deploy() 可以从一个路径中部署PyWebIO应用。位于该路径下的 python文件需要包含名字为 main 的PyWebIO任务函数才能被视为PyWebIO应用 程序。服务端会根据用户访问的URL来确定需要加载的文件并从中读取 PyWebIO应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py └── c nx)之后， 可能需要特别配置 反向代理来支持WebSocket协议，这里 有一个Nginx配置WebSocket的例 子。 明。 PyWebIO的会话实现默认是基于线程的，用户每打开一个和服务端的会话连 接，PyWebIO会启动一个线程来运行任务函数。 除了基于线程的会话， PyWebIO还提供了基于协程的会话。基于协程的会话接受协程函数作为任务函 数。 基于协程的会话为单线程模型，所有会话都运行在一个线程内。对于IO密集型

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 使用path_deploy() 可以从一个路径中部署 PyWebIO 应用。位于该路径下的 python 文件需要包含名字为 main 的 PyWebIO 任务函数才能被视为 PyWebIO 应用程序。服务端会根据用户访问的 URL 来确定需要加载 的文件并从中读取 PyWebIO 应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 使用path_deploy() 可以从一个路径中部署 PyWebIO 应用。位于该路径下的 python 文件需要包含名字为 main 的 PyWebIO 任务函数才能被视为 PyWebIO 应用程序。服务端会根据用户访问的 URL 来确定需要加载 的文件并从中读取 PyWebIO 应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 使用path_deploy() 可以从一个路径中部署 PyWebIO 应用。位于该路径下的 python 文件需要包含名字为 main 的 PyWebIO 任务函数才能被视为 PyWebIO 应用程序。服务端会根据用户访问的 URL 来确定需要加载 的文件并从中读取 PyWebIO 应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 4.11 服务器-客户端通信协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 5 Indices and 这个文档同时也提供 PDF 和 Epub 格式. 4.1 User’s guide 如果你接触过 Web 开发，你可能对接下来描述的 PyWebIO 的用法感到不太习惯，不同于传统 Web 开发的后 端实现接口、前端进行展示交互的模式，在 PyWebIO 中，所有的逻辑都通过编写 Python 代码实现。 你可以按照编写控制台程序的逻辑编写 PyWebIO 应用，只不过这里的终端变成了浏览器。通过 使用path_deploy() 可以从一个路径中部署 PyWebIO 应用。位于该路径下的 python 文件需要包含名字为 main 的 PyWebIO 任务函数才能被视为 PyWebIO 应用程序。服务端会根据用户访问的 URL 来确定需要加载 的文件并从中读取 PyWebIO 应用来运行。 例如，给定如下文件结构: . ├── A │ └── a.py ├── B │ └── b.py