Falcon v3.1.0 Documentation

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

摘要

文档介绍了Falcon框架的最新版本（v3.1.0）的更新内容，包括对CPython 3.10的支持和对Python 3.6的弃用。新增了对ASGI支持的增强，改进了错误处理和响应处理，修复了一些重要bug，并优化了性能。

AI总结

### Falcon 框架文档总结

Falcon 是一个高性能的 Web 框架，专注于快速开发高效且可扩展的 Web 应用程序。以下是各版本的主要更新和核心内容总结：

---

#### **Falcon 3.1.0**
1. **新功能与改进**
- **请求验证与错误处理**：增强了请求验证和错误处理的逻辑。
- **TestClient 和 ASGIConductor 的快捷方法**：新增 `simulate_get()` 等方法的快捷调用方式（如 `get()`）。
- **支持 CPython 3.10**：新增对 CPython 3.10 的支持，弃用 CPython 3.6（将在 Falcon 4.0 中移除）。
- **性能优化**：修复了可能导致应用卡死的问题，特别是在处理分块传输编码的请求流时。

2. **弃用与移除**
- CPython 3.6 已被弃用，将在 Falcon 4.0 中移除。

---

#### **Falcon 3.0.0**
1. **主要更新**
- **ASGI 支持**：新增基于 ASGI 的 asyncio 和 WebSocket 支持，提升了异步处理能力。
- **multipart/form-data 解析**：增强了文件上传和表单数据的解析能力。
- **错误处理改进**：优化了错误处理机制，新增了 `HTTPUriTooLong` 和 `HTTPGone` 等错误类。
- **兼容性改进**：尽量减少破坏性更改，但部分方法和属性已被弃用。

2. **重要变化**
- **移除全局钩子**：移除了 deprecated 的全局钩子功能，建议迁移到中间件。
- **中间件兼容性**：`process_resource()` 方法新增参数，支持处理路由 URI 模板中的字段。

3. **性能优化**
- 提升了响应体的生成性能，移除了 `Response.body_encoded` 属性。

---

#### **Falcon 3.0.1**
1. **修复**
- **模块重命名**：修复了 `api_helpers` 模块的重命名问题，该模块已 deprecated，将在未来版本中移除。
- **ASGI 头处理**：修复了 ASGI 头的编码问题，确保与 WSGI 兼容。

2. **其他**
- 依赖管理：将 `six` 包的版本固定为 1.4.0 或更高。

---

#### **Falcon 1.4.0**
1. **新功能**
- **静态路由支持**：新增 `add_static_route()` 方法，支持从本地目录 serving 文件。
- **WebDAV 支持**：新增对 WebDAV 方法（如 `UPDATE` 和 `REPORT`）的支持。
- **辅助方法**：新增 `get_param_as_uuid()` 和 `downloadable_as` 属性。

2. **改进**
- **JSON 处理**：默认使用 `ujson` 提升 JSON 序列化性能。
- **钩子支持**：允许向钩子传递参数。

3. **弃用**
- CPython 3.3 已 deprecated，将在 Falcon 2.0 中移除。

---

#### **其他版本简要说明**
- **Falcon 1.1.0**：
- 新增 `bounded_stream` 和 `uri_template` 属性，优化了请求处理的阻塞行为。
- 支持 CSV 样式的查询参数解析。
- 新增 `accept_ranges` 属性和 `HTTPGone` 错误类。

- **Falcon 0.3.0**：
- 新增路由架构，支持 URI 模板中的多个参数字段。
- 支持 cookies 的读写和 Jython 2.7。
- 新增日期查询参数解析和状态码常量（如 `falcon.HTTP_NO_CONTENT`）。

- **Falcon 1.0.0**：
- 移除了 deprecated 的全局钩子功能，新增中间件支持。
- 默认不再自动解析 `application/x-www-form-urlencoded` 请求，需手动启用。

---

### 总结
Falcon 框架在各版本中持续优化性能、扩展功能，并努力保持向后兼容性。用户在升级时需注意检查 Breaking Changes 和已 deprecated 的功能，确保应用顺利迁移。