Tornado 5.1 Documentation

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

摘要

文档主要介绍了Tornado 5.1版本的各个模块和更新内容，包括TCP服务器、协程、队列、HTTP工具、WebSocket等。Tornado 5.1版本新增了对Future异常处理的支持，优化了HTTP服务器的连接处理，增强了WebSocket的压缩功能，并改进了多进程、日志、测试工具等方面的功能。此外，文档还详细记录了各版本的更新日志，涵盖了从Tornado 1.0到5.1的所有重要变更。

AI总结

《Tornado 5.1 Documentation》总结如下：

---

# Tornado 5.1 文档总结

## 1. 模块功能概述
Tornado 是一个 Python 异步 网络框架，支持构建 高性能的 Web 应用程序 和服务。其模块功能主要包括以下几个方面：
- **基础功能**：提供 TCP 服务器（`tornado.tcpserver`）、异步 DNS 解析（`caresresolver`）、并发控制（`tornado.locks`）等。
- **协程与并发**：支持生成器风格的协程（`tornado.gen`）、队列（`tornado.queues`）、进程工具（`tornado.process`）和与其他框架的集成（如 asyncio、Twisted）。
- **集成服务**：提供与其他服务的交互支持，包括第三方登录（`tornado.auth`）、WSGI compatibility（`tornado.wsgi`）。
- **实用工具**：包括自动重载（`tornado.autoreload`）、日志记录（`tornado.log`）、命令行解析（`tornado.options`）等。
- **测试支持**：提供异步代码的单元测试工具（`tornado.testing`）。

---

## 2. 版本更新说明
文档详细记录了 Tornado 各版本的更新内容，重点包括：
- **5.1 版本**：
- 支持 HTTP/1.1.1协议。
- 提供更好的性能优化和安全增强。
- `tornado.httpclient` 支持流式处理。
- **4.5 版本**：
- 增加了对 `asyncio` 的支持。
- 引入 `trusted_downstream` 参数以增强安全性。
- **4.2 版本**：
- `HTTPServer` 现为 `tornado.util.Configurable` 的子类。
- **4.1 版本**：
- 新增 `tornado.gen.WaitIterator` 用于异步任务迭代。
- WebSocket 支持压缩扩展。
- 支持在协程中使用 `asyncio.Future` 和 Twisted Defered 对象。

---

## 3. 模块改进与新特性
- **HTTP 客户端**：
- 支持 PATCH 方法的请求正文。
-\Redirect 跟踪时保留请求正文。
- **WebSocket**：
- 修复压缩扩展的持续帧处理问题。
- **模板引擎**：
- 增加对空白处理的配置选项。
- 支持非 ASCII 文件名。
- **日志与性能**：
- 未检查的 Future 异常会在垃圾回收时记录堆栈跟踪。
- Future 现在会捕获和记录回调中的异常。
- **测试工具**：
- `ExpectLog` 对象新增 `logged_stack` 属性，便于测试异常栈跟踪。

---

## 4. 回溯兼容性与移除计划
- **回溯不兼容的改动**：
- `HTTPServerConnectionDelegate.start_request` 的参数数量由 1 个变为 2 个。
- `HTTPServer` 的 `io_loop` 参数已移除。
- **废弃计划**：
- `write` 方法的 `callback` 参数将在 Tornado 6.0 中移除。

---

## 5. 文档与支持
文档提供了详细的索引和搜索功能，并介绍了如何通过邮件列表、GitHub 问题追踪器获取支持。此外，文档内容遵循 Apache License 2.0 和 Creative Commons 3.0 许可。

---

## 总结
Tornado 5.1 是一个功能强大的异步网络框架，提供了丰富的模块和工具，适用于构建高性能的 Web 应用和服务。其版本更新注重性能优化、安全增强和与其他框架的兼容性，同时保持了良好的向后兼容性。