Falcon v3.1.1-rc1 Documentation

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

摘要

Falcon是一个专注于构建高可靠性、高性能REST API和微服务的 minimalist ASGI/WSGI框架。文档介绍了Falcon v3.1.1-rc1版本的更新，包括支持CPython 3.11、修复Forwarded头处理和or-json库兼容性问题。Falcon强调简洁设计，提供裸金属性能，支持ASGI、WSGI和WebSocket，适合大规模应用。框架不依赖魔法全局变量，注重RFC遵循和直观的错误响应，支持CPython 3.5+和PyPy 3.5+。

AI总结

Falcon 是一个轻量级的 ASGI/WSGI 网络框架，专注于构建高性能的 REST API 和微服务，强调可靠性、正确性和大规模性能。框架遵循 REST 架构风格，简单高效，避免过度封装，适合需要高性能和灵活性的场景。

### 核心特点
1. **高性能**：Falcon 在处理大规模请求时表现出色，支持 CPython 3.5+ 和 PyPy，提供裸金属性能。
2. **可靠性**：框架注重稳定性，避免破坏性更改，严格遵循 HTTP RFC 标准。
3. **灵活性**：支持 ASGI、WSGI 和 WebSocket，提供原生的 asyncio 支持，允许开发者自定义实现细节。
4. **轻量级设计**：无魔法全局变量，避免隐藏状态，便于调试和维护。

### 主要功能
- **REST 支持**：通过集中式路由实现 RESTful API。
- **扩展性**：框架代码经过优化，便于扩展。
- **高效的请求处理**：提供对头和正文的直接访问，支持中间件和钩子。
- **错误处理**：提供默认的错误处理机制，支持自定义错误处理器。

### 版本更新
- **Falcon 3.1.1**：
- 支持 CPython 3.11。
- 修复了与无效或空的 Forwarded 标头处理相关的 IndexError 问题。
- 修复了 ASGI 版本中或-json 库的 JSON 序列化问题。
- 弃用 Python 3.5 和 3.6，不再支持 Python 3.6。

- **Falcon 3.1.0**：
- 新增对 CPython 3.10 的支持，弃用 Python 3.6。
- 提升了请求验证和错误处理的体验。
- TestClient 和 ASGIConductor 增加了快捷方法（如 `simulate_get()` 等）。
- 修复了与分块传输编码请求处理相关的潜在问题。

### 性能优化
- Falcon 在相同硬件条件下比其他 Python 框架处理更多请求。
- 支持通过 Cython 和 PyPy 提升性能。

### 兼容性
- Falcon 不依赖外部库，支持多种 WSGI 服务器，与 ASGI 兼容。

### 适用场景
Falcon 适合构建大规模微服务和 API 后端，尤其适用于需要高性能、可靠性和灵活性的场景。

### 开源与许可
Falcon 以 Apache 2.0 许可证发布，允许商业用途，并保护贡献者的专利权益。

### 总结
Falcon 是一个 minimalist 的 Web 框架，专注于高性能和可靠性，适合构建 REST API 和微服务。其最新版本（3.1.1）增强了对 CPython 3.11 的支持，并修复了关键问题，同时保持了对大规模应用的优化支持。