Falcon v3.1.1-b3 Documentation

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

摘要

文档介绍了Falcon v3.1.1-b3版本的更新内容，包括新增功能、错误修复和改进。主要更新包括_test_client_的新配置、测试框架的增强、WebSocket支持的优化以及文档的重组和扩展。此外，Falcon支持ASGI、WSGI和WebSocket协议，适用于构建高性能Web应用和微服务。文档还涵盖了功能测试框架、媒体处理和中间件支持，强调了向后兼容性和性能优化。

AI总结

以下是对《Falcon v3.1.1-b3 Documentation》的总结，突出核心观点和关键信息，语言简洁明了，逻辑连贯：

---

### 1. **版本更新与变更日志（Changelogs）**
- **新增功能**：
- `simulate_request()` 等方法添加了新的 `json` 参数，用于自动将请求正文从 JSON 可序列化对象序列化。
- `TestClient` 的 `simulate_*()` 方法现在调用 `simulate_request()`，便于子类覆盖 `TestClient` 的行为。
- `TestClient` 支持配置默认头文件，发送每次请求时自动包含。
- 重组并大幅扩展了 FAQ 部分。
- 文档样式更新，匹配 [falconframework.org](https://falconframework.org)。

- **修复**：
- 修复了转发头解析错误，特别是含有逗号的引号字符串。
- 修复了 Python 2.x 下 JSONHandler 序列化 Unicode 字符串时的错误。
- 修复了通过 `super()` 调用资源类响应者时，URI 模板参数作为位置参数传递的问题。
- 修复了 Python 3.6 下字符串含 `\s` 时的警告。
- 修复了文档代码示例中的语法错误。

- **贡献者**：
- 特别感谢本次发布的贡献者，包括：GriffGeorge、hynek、kgriffs 等。

---

### 2. **功能测试框架**
- Falcon 提供了功能测试框架，支持 `unittest` 和 `pytest`。
- **unittest 示例**：

    from falcon import testing
    class MyTestCase(testing.TestCase):
        def setUp(self):
            super(MyTestCase, self).setUp()
            self.app = myapp.create()

        def test_get_message(self):
            doc = {'message': 'Hello world!'}
            result = self.simulate_get('/messages/42')
            self.assertEqual(result.json, doc)

- **pytest 示例**：

    from falcon import testing
    import pytest

    @pytest.fixture()
    def client():
        return testing.TestClient(myapp.create())

---

### 3. **框架参考**
- **核心特性**：
- 支持 ASGI、WSGI 和 WebSocket。
- 原生 asyncio 支持。
-assic interfaces，强调向后兼容性。
- 简化的 RESTful 路由 API。
- 高性能、可扩展代码库。
- 遵循 RFC，支持 HTTP 错误响应。
- 简便的测试工具。

- **WebSocket 支持**：
- 基于 ASGI WebSocket 规范，支持实时通信。
- 支持 Server-Sent Events (SSE)。
- 通过实现 `on_websocket()` 响应式在路由中添加 WebSocket 支持。

- **测试框架**：
- 提供 `TestClient` 和模拟请求方法，支持功能测试。

---

### 4. **常见问题与解答**
- **请求处理**：
- 如何处理正向斜杠在路径模板中？
- 如何访问 POST 表单参数或文件？
- 如何保存 POST 表单文件到 AWS S3？
- 如何解析嵌套的多部分表单？
- 如何从查询字符串中检索 JSON 值？

- **响应处理**：
- 什么时候使用 `media`、`data`、`text` 和 `stream`？
- 如何处理.datetime 类型的响应？
- 是否需要显式设置 Content-Length？
- 为什么检测到 HTTPError 实例时返回空响应正文？

- **其他**：
- 如何管理数据库连接？
- 如何测试 Falcon 应用？可以使用 pytest 吗？

---

### 5. **设计理念**
- Falcon 遵循极简主义设计，不内置过多功能，允许开发者根据需求选择第三方包。
- 核心目标是高性能和高度定制化，适合构建大规模应用后端和微服务。

---

以上是文档的核心内容和关键信息的总结，涵盖了版本更新、功能测试框架、框架参考、常见问题解答和设计理念等部分。