Falcon v2.0.0 Documentation

• 语言: 英语
• 格式: .epub
• 来源: falcon.readthedocs.io

摘要

文档介绍了Falcon框架2.0.0版本的更新内容，包括新功能、性能优化、对Python版本的支持变化以及弃用的部分。主要改进包括新增了中间件功能，优化了对Response class的上下文处理方式，支持CPython 3.7，并移除了对CPython 2.7和PyPy2.7的支持。文档还提到Request context和Response context的默认类型改为bare class，以提高属性设置的效率。此外，框架对旧版本的兼容性进行了调整，并修复了多个错误，提升了整体性能和可维护性。

AI总结

### Falcon 2.0.0 文档总结

#### 版本概述
Falcon 2.0.0 是该项目的一个重要版本更新，引入了许多新功能、性能优化和改进，同时也进行了多项 API 的调整和弃用。以下是核心内容的总结：

---

#### 1. **新功能与改进**
- **上下文属性支持**
- 请求（`Request`）和响应（`Response`）的上下文现在默认支持属性设置，例如：

    # 旧方法
    req.context['role'] = 'trial'
    req.context['user'] = 'guest'
    # 新方法
    req.context.role = 'trial'
    req.context.user = 'guest'

- 旧的字典接口仍然支持，但已标记为弃用，未来可能移除。

- **请求处理短路**
- 新增 `complete` 属性，允许在响应已预先构建时短路请求处理流程。

- **中间件功能**
- 引入新的中间件功能，取代了旧的全局钩子（hooks），建议尽快迁移。

- **WSGI 文件流支持**
- 支持 `wsgi.filewrapper`，允许将文件对象直接赋值给响应流（`resp.stream`），以更高效地处理大数据传输。

- **表单解析**
- 自动解析 `application/x-www-form-urlencoded` 类型的请求内容，并将其字段合并到 `req.params` 中。

- **错误处理增强**
- 支持 XML 格式的错误响应，同时优化了错误处理逻辑，使其更易于扩展和定制。

- **性能优化**
- 对热点代码路径进行了性能优化，Falcon 2.0 在某些场景下比 1.4 更快。

---

#### 2. **兼容性与弃用**
- **Python 版本支持**
- 完全支持 CPython 3.7。
- CPython 2.7 和 PyPy2.7 支持将被移除（计划在 Falcon 3.0）。
- CPython 3.4 已被弃用，将在 Falcon 3.0 移除。
- Jython 2.7 已完全移除。

- **API 弃用与调整**
- 移除了 `utilmisc.percent_escape` 和 `utilmisc.percent_unescape` 函数，建议使用 `util.uri` 模块中的替代函数。
- 移除了 `API.set_default_route` 方法，建议使用 sinks 替代。

- **Cookie 和 ETag 处理**
- 修复了 `Response` 类中设置原始 Cookie 头的问题，不再使用逗号分隔列表的方式。

---

#### 3. **文档改进**
- 文档的准确性和清晰度得到显著提升，新增了大量指南和推荐实践，便于新手快速上手。
- 新增了对 `application/xml` 格式错误响应的支持，并优化了错误处理的代码结构。

---

#### 4. **其他重要信息**
- **默认值调整**
- 根据社区反馈，调整了多个请求选项的默认值。

- **依赖管理**
- 移除了 `six` 和 `python-mimeparse` 依赖，减少了项目开销。

- **错误处理**
- 未处理的异常不会被封装或隐藏，所有意外行为均被充分记录。

---

#### 总结
Falcon 2.0.0 通过多项新功能和性能优化，显著提升了框架的易用性和扩展性。同时，对旧 API 的调整和 Python 版本的支持变化需要注意。建议开发者仔细阅读文档中的 **Breaking Changes** 部分，确保现有代码与新版本兼容。