Tornado 6.2 Documentation

• 语言: 英语
• 格式: .epub
• 来源: www.tornadoweb.org

摘要

文档为Tornado 6.2官方文档，涵盖核心概念、模块功能及版本变更。Tornado要求Python 3.7+，支持Unix-like平台（Linux epoll、BSD/macOS kqueue等），Windows不推荐生产使用。文档介绍异步非阻塞I/O、协程、Web应用结构、模板、认证安全等用户指南，以及web、HTTP服务器/客户端、异步网络、协程并发、第三方集成、工具等模块。重要变更包括：tornado.stack_context、tornado.platform.twisted等模块废弃，将在6.0移除；ioloop.PeriodicCallback新增jitter参数；websocket支持RFC 6455协议及子协议；HTTPClientError重命名；gen.coroutine不再接受回调参数等。文档还包含FAQ、发布说明及PDF/Epub格式下载。

AI总结

Tornado 6.2 要求 Python 3.7 或更高版本。可选依赖包括 pycurl（用于 curl_httpclient，需 libcurl 7.22+）和 pycares（替代 DNS 解析器）。Tornado 专为类 Unix 平台设计，在支持 epoll（Linux）、kqueue（BSD/macOS）或 /dev/poll（Solaris）的系统上性能最佳。虽然可在 Windows 上运行，但官方不推荐用于生产环境，且缺少多进程模式，可扩展性有限。

文档结构包括用户指南、Web 框架、HTTP 服务器与客户端、异步网络、协程与并发、与其他服务集成以及工具模块。文档还提供了从 4.4.2 到 6.2.0 的发布说明。

6.0 版本中大量功能被弃用，并将在后续版本中移除，例如：`tornado.ioloop` 中的 `set_blocking_signal_threshold` 等方法；`tornado.iostream` 中的大部分回调参数；`tornado.platform.twisted` 中的 `TornadoReactor` 和 `TwistedIOLoop`；`tornado.stack_context` 模块；`tornado.gen` 中的 `engine`、`YieldPoint`、`Callback`、`Wait`、`WaitAll`、`MultiYieldPoint` 和 `Task`；`tornado.httpclient` 中的 `callback` 参数；以及 `tornado.websocket` 中默认不再支持旧的 “draft 76” 版本。

6.0 版本引入了多项改进：`tornado.ioloop.PeriodicCallback` 支持 `jitter` 参数；`tornado.concurrent.run_on_executor` 返回兼容 `await` 的 Future；`tornado.httpclient.HTTPError` 重命名为 `HTTPClientError`；`tornado.httputil.parse_multipart_form_data` 支持 RFC 2231/5987 格式的非 ASCII 文件名；`tornado.websocket` 支持 RFC 6455 协议、二进制消息和子协议；`tornado.gen` 支持 yield 字典；`tornado.httpserver` 对格式错误的请求体仅记录警告；`tornado.web` 支持 cookie 密钥版本控制；`tornado.simple_httpclient` 新增 `max_body_size` 参数并复用 SSLContext。

旧版文档中提及的 `tornado.platform.twisted` 模块已弃用，建议新应用使用 asyncio 集成。`TwistedResolver` 作为基于 Twisted 的异步解析器，返回结果有限，仅推荐在无法使用线程时使用。