Falcon v3.0.1 Documentation

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

摘要

文档主要介绍了Falcon框架的版本更新，特别是3.0.1和3.0.0的更新内容。3.0.0版本引入了对ASGI和WebSocket的支持，改进了错误处理和性能，并弃用了一些旧功能。文档还提到了新的静态路由功能、请求参数处理方式以及对Jython和PyPy的支持。此外，3.0.1版本修复了与WSGI兼容性相关的问题，并重新添加了已弃用的模块。文档还包括安装指南和使用教程，帮助用户更好地理解和使用Falcon框架。

AI总结

### 总结

#### Falcon 3.0.1 更新日志
- **修复问题**：
- 重新添加了 `api_helpers` 模块（之前因重命名为 `app_helpers` 而未宣布此变更）。
- 修复了 ASGI 头处理问题，ASGI 头现在使用 ISO-8859-1 解码和编码，而不是 UTF-8。

#### Falcon 3.0.0 更新日志
- **重大更新**：
- 引入了基于 ASGI 的 asyncio 和 WebSocket 支持。
- 提升了错误处理和性能优化。
- 支持 `multipart/form-data` 解析。
- 新增 `auto_parse_form_urlencoded` 选项，默认禁用自动解析表单数据。
- `HTTPUnauthorized` 初始化器现在需要 `challenges` 参数。
- �移除了已弃用的全局钩子功能，建议迁移到中间件。
- `process_resource()` 方法新增 `params` 参数，支持 URI 模板字段交互。
- 响应体构建性能提升，移除了 `Response.body_encoded` 属性。

#### Falcon 1.4.0 更新日志
- **重大更新**：
- 新增 `add_static_route()` 方法，支持从本地目录 serving 文件。
- 支持 WebDAV 方法（如 `UPDATE` 和 `REPORT`）。
- 新增 `get_param_as_uuid()` 方法和 `downloadable_as` 属性。
- 默认使用 `ujson` 加快 JSON 处理速度。
- 支持 Python 3.5+ 和 PyPy 3.5+。

#### 用户指南
- **安装**：
- 支持 PyPy 和 CPython（3.5+）。
- 提供预编译二进制包和源码包，可选 Cython 加速。
- **快速上手**：
- 提供了 WSGI 和 ASGI 的教程，涵盖资源创建、路由配置、错误处理等功能。
- **功能亮点**：
- 支持自定义路由器和 URI 模板。
- 改进的媒体类型处理和状态码常量。
- 新增钩子和测试工具。

#### 总结
Falcon 是一个高性能的 Web 框架，支持 WSGI 和 ASGI，适合构建高效、灵活的 Web 应用。3.0 版本是迄今为止最重要的更新之一，引入了 ASGI 支持和多项性能优化，同时保持了对现有功能的兼容性。