Tornado 5.1 Documentation

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

摘要

文档详细介绍了Tornado框架，包括其主要组件：Web框架、HTTP客户端和服务器、异步网络库及协程库。文档中列出了Tornado 5.1.1版本的更新内容，涉及多个模块的改进与修复，如tornado.curl_httpclient、tornado.escape、tornado.gen等。此外，文档还提供了Tornado的使用指南、安装说明及讨论与支持信息，介绍了如何利用Tornado高效处理非阻塞网络I/O，实现长连接应用。

AI总结

《Tornado 5.1 Documentation》主要涵盖了Tornado框架的更新内容、功能改进以及修复的漏洞，以下是核心内容的总结：

### 主要更新与改进
1. **模块更新与功能改进**：
- **tornado.curl_httpclient**：修复了客户端在队列存在时因异常停止处理请求的问题。
- **tornado.escape**：`xhtml_escape`现在支持十六进制字符引用（如` `）。
- **tornado.gen**：
- `WaitIterator`不再使用弱引用，修复了与垃圾回收相关的错误。
- `Multi`和`multi_future`在多个`Future`失败时会记录异常，新增`quiet_exceptions`参数可抑制特定异常的日志记录。
- `multi_future`现在支持处理相同的`Future`实例。
- **tornado.httpclient**：`raise_error`参数在同步`HTTPClient`中正确工作。
- **tornado.httpserver**：`HTTPServer`现在是`Configurable`的子类。
- **tornado.httputil**：`HTTPHeaders`现在支持`copy.copy`和`copy.deepcopy`。
- **tornado.ioloop**：
- `IOLoop`构造函数新增`make_current`参数，控制新实例是否成为当前的`IOLoop`。
- `PeriodicCallback`在时钟跳跃大幅度时效率更高。
- **tornado.web**：
- `RequestHandler.set_status`不再要求状态码在`http.client.responses`中。
- 1xx或204响应不再允许发送请求正文。
- 重定向处理器现在会将请求的查询参数复制到重定向位置。
- **tornado.websocket**：
- 加速器现在批量处理字节以提高性能。
- 无效的WebSocket头部请求会返回400状态码。
- `WebSocketHandler.write_message`在写入过程中连接关闭时会抛出`WebSocketClosedError`。

2. **安全修复**：
- **cookie解析器**：修复了潜在的安全漏洞，使cookie解析更符合浏览器行为，避免了攻击者绕过XSRF保护的风险。

3. **性能与兼容性**：
- **tornado.iostream**：修复了`memoryview`写入可能导致的`BufferError`。
- **tornado.tcpserver**：改进了对大时间跳跃的处理。
- **tornado.auth**：更新以兼容Facebook的访问令牌端点的变更。

4. **文档与支持**：
- Tornado文档提供PDF和Epub格式。
- 社区支持通过邮件列表、GitHub问题追踪器和Stack Overflow进行。

### 总结
Tornado 5.1主要集中在改善异步编程的可靠性、修复关键漏洞、提高性能以及优化API的易用性，涵盖了从网络协议处理到Web框架的多个方面。这些改进使Tornado在处理高并发和长连接场景时性能更强、安全性更高。