Tornado 6.5 Documentation

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

摘要

Tornado 6.5版本文档详细介绍了该框架的更新内容，包括新功能、性能改进和不兼容的变化。主要更新包括引入了新的异步HTTP客户端，改进了日志配置，支持WebSocket协议的最新版本，优化了SSL和gzip支持，以及对模块和功能的多项改进。文档还列出了与旧版本不兼容的更改，帮助开发者顺利过渡到新版本。

AI总结

《Tornado 6.5 文档》总结如下：

### 核心特性与改进

1. **性能与兼容性**
- 提升了在 Mac OS X 和 BSD 系统上的性能（基于 kqueue 的 IOLoop）。
- 实验性支持 Windows 系统。
- 新增 `tornado.platform.twisted` 模块，支持在 Twisted 平台上运行 Tornado 代码。

2. **HTTP 与 Web 请求**
- 支持通过 `reverse_url()` 函数根据名称引用 URL。
- 静态文件支持自定义 URL 前缀（`static_url_prefix`）。
- 支持在 URL 正则表达式中使用命名组（`(?P)`）传递参数。
- HTTP 头支持多值，可通过 `get_all()` 和 `add()` 方法处理。

3. **安全性**
- 提升了安全 cookie 的安全性，不兼容旧版本 Tornado 设置的 cookie。
- `SimpleAsyncHTTPClient` 禁用 SSLv2，仅支持 SSLv3 和 TLSv1。
- 修复了 `SimpleAsyncHTTPClient` 在处理 304 状态码时的漏洞。

4. **新功能**
- 新增 `RequestHandler.on_finish()` 方法，用于后处理逻辑。
- `StaticFileHandler` 支持自定义版本号和 URL 解析方法。
- `WebSocketHandler.write_message()` 支持二进制消息。
- 支持 WebSocket 子协议（`Sec-WebSocket-Protocol` 头）。

5. **模块增强**
- `tornado.options`：支持独立选项集，新增 `add_parse_callback` 和 `define` 的回调功能。
- `tornado.template`：改进模板错误处理，支持多行指令和 `{#}` 注释。
- `tornado.process`：新增 `Subprocess` 类，支持子进程管理。
- `tornado.stack_context`：改进上下文管理，修复泄漏问题。

6. **测试与调试**
- 新增 `tornado.testing.gen_test` 装饰器，支持异步测试。
- `LogTrapTestCase` 更兼容不同日志配置。
- 提升模板错误堆栈跟踪的详细性。

### 不兼容变更

1. **Cookie**
- 安全 cookie 不兼容旧版本 Tornado，需使用 `include_name=False` 读取旧 cookie。

2. **HTTP 请求**
- `RequestHandler.get_error_html()` 现在接收异常对象作为关键字参数。

3. **WebSocket**
- 默认不再支持旧版“draft 76”协议，需手动启用。

### 总结

Tornado 6.5 版本在性能、安全性、兼容性和功能扩展方面均有显著提升，特别增强了对异步处理、WebSocket 支持和模块化的灵活性。开发者在升级时需注意不兼容的变更，确保应用顺利迁移。