Tornado 6.4 Documentation

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

摘要

Tornado 6.4文档概述了该异步网络框架的核心特性和更新。Tornado 6.3需Python 3.8以上，支持epoll(Linux)、kqueue(BSD/macOS)等平台，Windows上部分功能缺失。6.4.0版本新增Python 3.12支持，废弃IOLoop.add_callback from signal、OAuth2Mixin.authorize_redirect的client_secret参数及TwitterMixin。autoreload模块新增--until-success标志。文档涵盖Web框架、HTTP服务器/客户端、异步网络、协程与并发等模块，并包含从1.0到6.4的版本历史。4.0版本引入流式请求体装饰器、协程性能优化、tornado.tcpclient模块及WebSocket跨域默认拒绝等变更。

AI总结

Tornado 6.4.0 文档总结：

**前提与平台支持**
- Tornado 6.3 要求 Python 3.8 或更高版本
- 可选依赖：pycurl（需 libcurl 7.22+）、pycares（非阻塞 DNS 解析器）
- 主要支持 Unix 类平台（Linux 的 epoll、BSD/macOS 的 kqueue、Solaris 的 /dev/poll）
- Windows 上可运行但不官方支持，缺少多进程模式且扩展性受限

**Tornado 6.4.0 新特性（2023年11月28日）**
- 新增对 Python 3.12 的支持
- 弃用通知：
- `IOLoop.add_callback` 从信号中调用自 5.0 版本起存在问题，将在 7.0 移除，建议改用 `asyncio.loop.add_signal_handler`
- `OAuth2Mixin.authorize_redirect` 的 `client_secret` 参数从未被使用，将在 7.0 移除
- `TwitterMixin` 已弃用，将在未来移除
- `tornado.autoreload`：支持以目录方式运行程序；新增 `--until-success` 命令行标志
- `tornado.concurrent`：修复了导致内存使用增加的回环引用问题
- `tornado.escape`：修复了 `simple_httpclient` 中某些错误导致超时的回归问题

**Tornado 4.0 新特性（2014年7月15日）**
- 支持大文件流式上传，内存占用低
- 协程速度提升，并在 Tornado 内部广泛使用
- 许多用户可重写的方法现在可返回 Future 对象以控制流程
- HTTP 相关代码在 `httpserver`、`simple_httpclient` 和 `wsgi` 模块间共享，分块和 gzip 编码支持更一致
- 新增 `tornado.tcpclient` 模块，支持非阻塞 DNS、SSL 握手和 IPv6
- 向后兼容性注意：
- `tornado.concurrent.Future` 不再线程安全
- 依赖 `certifi` 包而非自带 Mozilla CA 列表
- 默认拒绝跨源 WebSocket 连接，需重写 `WebSocketHandler.check_origin`
- WebSocket 不再支持旧的 draft 76 协议

**文档结构**
文档涵盖用户指南（异步非阻塞 I/O、协程、Web 应用结构、模板、认证安全、部署）、Web 框架（`tornado.web`、`tornado.template`、`tornado.routing`、`tornado.escape`、`tornado.locale`、`tornado.websocket`）、HTTP 服务器与客户端（`tornado.httpserver`、`tornado.httpclient`、`tornado.httputil`、`tornado.http1connection`）、异步网络（`tornado.ioloop`、`tornado.iostream`、`tornado.netutil`、`tornado.tcpclient`、`tornado.tcpserver`）、协程与并发（`tornado.gen`、`tornado.locks`、`tornado.queues`、`tornado.process`）、第三方服务集成（`tornado.auth`、`tornado.wsgi`、`tornado.platform` 系列）、工具（`tornado.autoreload`、`tornado.concurrent`、`tornado.log`、`tornado.options`、`tornado.testing`、`tornado.util`）以及发布说明。