Falcon v1.3.0 Documentation

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

摘要

文档详细介绍了Falcon 1.3.0版本的更新内容，包括新功能、性能优化和问题修复。新增功能如支持JSON Schema的序列化和反序列化，URI模板字段转换器，新增的请求和响应属性等。性能方面，Response.content_range的性能提升了约50%。修复了包括Cookie解析、错误处理、路由系统等多个问题，提升了框架的稳定性和兼容性。

AI总结

### Falcon v1.3.0 文档总结

Falcon 是一个高性能的 Python Web 框架，专注于构建快速、轻量且易于扩展的应用程序。以下是《Falcon v1.3.0 Documentation》的核心内容总结：

---

#### **主要功能更新**
1. **新功能与改进**
- **URI 模板支持**：允许在 `falcon.routing.compile_uri_template()` 中使用通配符字段，支持自定义路由实现。
- **新的测试框架**：提供更直观的测试体验，支持 WSGI 验证。
- **性能优化**：`Response.content_range` 的设置性能提升约 50%。
- **新参数 `obs_date`**：在 `falcon.Request.get_header_as_datetime()` 中增加，优化处理过时日期格式。
- **支持 `functools.partial()` 定义的钩子**。
- **UTF-8 字符解码**：正确解码请求路径中的转义字符，并替换无效代码点。
- **延迟初始化 `Request.context_type`**：避免依赖 `Request` 属性的初始化顺序问题。

2. **兼容性改进**
- **支持 Jython 2.7**：增加对 Jython 环境的支持。
- **Cookie 处理**：支持设置和清除 Cookie，增加 `secure_cookies_by_default` 选项。
- **`strip_url_path_trailing_slash`**：控制 URL 路径末尾斜杠的保留行为。
- **`wsgi.file_wrapper` 支持**：优化文件流的处理。

3. **文档与工具**
- **改进文档**：更新了 `falcon.HTTPError` 和其他核心模块的文档。
- **测试框架增强**：支持 `pytest` 和 `unittest` 风格测试，增加 `falcon.testing.Cookie` 和 `Result` 类。
- **新 CLI 工具**：`falcon-print-routes` 可用于 introspect 和打印路由信息。

---

#### **修复的问题**
1. **路由与解析**
- 解决路由树中字段表达式冲突问题，确保所有可能的路由分支都被尝试。
- 修复请求流在 `wsqiref` 下的挂起问题。
- 解决百分编码查询字符串的解析问题。

2. **Cookie 与头信息**
- 修复 Cookie 过期时间设置问题。
- 解决 `Vary` 头在默认错误序列化中的设置问题。

3. **兼容性修复**
- 解决 `wsgiref` 环境下的响应状态码类型问题。
- 修复 `falcon.testing` 在 `Jython` 下的 Cookie 解析问题。

---

#### **版本兼容性**
- **Breaking Changes**：
- 无重大破坏性更改。
- **支持平台**：
- 官方支持 CPython 3.6，PyPy3.5 已知兼容但未官方支持。
- CPython 2.6 和 Jython 2.7 已弃用，将在 Falcon 2.0 中移除。

---

#### **其他重要改进**
1. **媒体类型与序列化**
- 支持基于 JSON Schema 的输入验证和序列化。
- 增加 XML 错误响应支持。

2. **性能与扩展性**
- 支持自定义路由实现和中间件。
- 增加 `falcon.RequestOptions` 和 `falcon.ResponseOptions` 的配置灵活性。

3. **错误处理**
- 新增多个 5xx 错误类（如 `HTTPFailedDependency`）。
- 支持自定义错误序列化器，便于扩展。

---

总结来看，Falcon 1.3.0 版本在性能、兼容性、测试框架和文档方面均有显著提升，适合需要高性能和灵活配置的 Web 开发场景。