Tornado 6.4 Documentation

《Tornado 6.4 Documentation》总结： --- ### **环境要求** - **Python版本**：Tornado 6.3 需要 Python 3.8 或更高版本。 - **可选包**： - `pycurl`：用于 `tornado.curl_httpclient`，需 Libcurl 7.22 或更高版本。 - `pycares`：非阻塞 DNS 解析器，适用于无线程环境。 --- ### **平台兼容性** - **Unix-like 平台**：Tornado针对Unix-like平台设计，性能和扩展性最佳，支持 epoll（Linux）、kqueue（BSD/macOS）或 /dev/poll（Solaris）。 - **Windows**：虽然支持 Windows，但不推荐用于生产环境，某些功能（如多进程模式）缺失，扩展性有限。 --- ### **文档与用户指南** - 本文档还提供 PDF 和 Epub 格式，链接为 [https://readthedocs.org/projects/tornado/downloads/](https://readthedocs.org/projects/tornado/downloads/)。 - 用户指南涵盖： - **异步与非阻塞 I/O**：介绍异步编程、协程、队列等。 - **Web 应用结构**：包括模板、UI、认证、安全、运行与部署等。 - **核心模块**： - `tornado.web`：`RequestHandler` 和 `Application` 类。 - `tornado.template`：灵活的输出生成。 - `tornado.websocket`：浏览器双向通信。 - **HTTP 服务与客户端**： - `tornado.httpserver`：非阻塞 HTTP 服务器。 - `tornado.httpclient`：异步 HTTP 客户端。 - **异步网络**：包括 `IOLoop`、`IOStream`、`TCPClient` 和 `TCPServer`。 - **协程与并发**：`tornado.gen`、`tornado.locks`、`tornado.queues` 和 `tornado.process`。 - **与其他服务集成**：如 `tornado.auth`（OAuth、OpenID 登录）、`tornado.wsgi`（WSGI 兼容性）。 - **工具**：包括 `tornado.autoreload`（自动刷新）和 `tornado.log`（日志支持）。 --- ### **发布说明** #### **新功能与改进** - **Tornado 6.4.0**： - 支持 Python 3.12，旧版本在 Python 3.12 上可能会引发弃用警告。 - `tornado.autoreload` 支持目录运行模式。 - `tornado_queues` 支持 `async for` 语句（Python 3.5+）。 - 模板_whitespace 模式默认为 `single`，支持更多配置选项。 - `StaticFileHandler` 对大文件头支持更好，压缩级别默认为 6。 - **其他版本更新**： - `tornado.simple_httpclient` 默认支持 `network_interface` 参数，优化了重定向处理。 - `tornado.tcpserver` 支持 `max_restarts` 参数。 - `tornado.testing` 取消了对 `stack_context` 的依赖。 - `tornado.template` 支持非 ASCII 文件名。 #### **弃用与移除** - `IOLoop.add_callback_from_signal` 将在 7.0 版本移除，建议使用 `asyncio.loop.add_signal_handler`。 - `OAuth2Mixin.authorize_redirect` 中的 `client_secret` 参数弃用。 - `TwitterMixin` 将在未来版本移除。 - `tornado.stack_context` 模块已移除。 --- ### **Tornado 简介** Tornado 是一个 Python 异步网络库和 Web 框架，适合处理长轮询、WebSocket 等长连接应用。其核心组件包括： 1. **Web 框架**：基于 `RequestHandler` 的 Web 应用开发。 2. **HTTP 服务器与客户端**：支持异步 HTTP 通信。 3. **异步网络库**：提供 `IOLoop` 和 `IOStream` 等基础组件。 Tornado 旨在通过非阻塞网络 I/O 实现高扩展性，适合需要处理大量并发连接的场景。 --- 以上为《Tornado 6.4 Documentation》的核心内容和关键信息总结，重点突出了版本更新、功能特性、弃用通知及平台兼容性等内容。