Tornado 6.3 Documentation

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

摘要

文档详细介绍了Tornado 6.3.3版本的功能和改进，其中包括其主要组件：Web框架、HTTP服务器及客户端实现、异步网络库等。Tornado通过非阻塞网络I/O实现高并发，适用于长连接场景，如实时Web应用。文档还列举了各模块的更新，如tornado.httpclient支持代理摘要认证，tornado.httputil优化了头部解析，tornado.gen增强了对contextvars的支持，并修复了多个安全漏洞和性能问题。同时，文档提供了安装指南、 사용者指南和讨论与支持的相关信息。

AI总结

以下是对《Tornado 6.3 Documentation》的总结，重点突出核心观点和关键信息：

---

### Tornado 6.3 Documentation 总结

#### 1. **Tornado 简介**
- Tornado 是一个 Python 웹框架和异步网络库，最初由 FriendFeed 开发。
- 核心组件：
* Web 框架（包括 `RequestHandler` 等）。
* HTTP 客户端和服务器实现（`HTTPServer` 和 `AsyncHTTPClient`）。
* 异步网络库（`IOLoop` 和 `IOStream`）。
- Tornado 使用单线程事件循环，支持非阻塞 I/O，适合长连接、WebSockets 等场景。

#### 2. **主要更新和改进**
- **新功能**：
* `tornado.gen` 新增 `is_coroutine_function` 函数，用于识别协程函数。
* `tornado.httpserver` 支持 `trusted_downstream` 参数，控制 X-Forwarded-For头的解析。
* `tornado.httputil` 的 `url_concat` 正确处理 URL 片段和现有查询参数。
* `tornado.iostream` 改进 SSL握手错误处理。
* `tornado.stack_context` 重写，性能显著提升。
- **性能改进**：
* `tornado.auth` 更新，兼容 Facebook 的访问令牌端点。
* `tornado.locale.format_date` 在 Python 3 上正常工作。
* `tornado.log` 支持彩色日志，关键消息突出显示。
- **安全更新**：
* 修复 cookie 解析漏洞，防止设置任意 cookie 并绕过 XSRF 保护。

#### 3. **Bug 修复**
- **内存泄漏**：修复子进程文件描述符泄漏问题。
- **性能问题**：修复潜在 CPU 像 DOS 攻击问题。
- **错误处理**：修复 `NoneType` 对象回调日志问题。
- **兼容性改进**：支持 Python 3.7+ 的上下文变量模块。

#### 4. **弃用和移除**
- `yield None` 替换为 `yield gen.moment`，提升与 asyncio 兼容性。
- 移除对 Python 2.6 和 3.2 的支持。

#### 5. **安装与依赖**
- 提供 Windows、MacOS 和 Linux 的二进制轮子。
- 最低支持 libcurl 版本为 7.22.0。

#### 6. **其他**
- Tornado 使用 Apache License 2.0 许可证。
- 文档以 PDF 和 Epub 格式提供。

---

以上是 Tornado 6.3.3 文档的核心内容总结，涵盖了主要功能更新、改进、Bug 修复和安全更新等关键信息。