Falcon v1.4.1 Documentation

语言	格式	评分
英语	.pdf	3
摘要
文档记录了Falcon框架v1.4.1版本的更新内容，包括错误处理的改进、文档的扩展、对WSGI服务器的支持优化、新功能的添加以及对不同Python版本的支持情况。文档还提到了对URI模板路径段的改进、对请求上下文的处理优化、对Cookie解析的修复以及对JSON查询参数的处理改进。
AI总结
### Falcon v1.4.1 文档总结 #### 1. 改进 - 错误处理：改进了 `falcon.HTTPError` 的文档，特别是在自定义错误序列化方面。 - 文档外观：优化了文档的整体呈现效果。 - 教程更新：教程中新增了关于如何测试 Falcon 应用的指导。 #### 2. 修复的问题 - URI 模板：修复了复杂 URI 模板路径段中包含括号等非字母数字字符的问题。 - 响应流：当 WSGI 服务器未提供 `wsgi.file_wrapper` 时，Falcon 现在会在响应流中实现 `close()` 方法以释放资源。 - Cookie 解析：修复了测试框架在 Jython 上解析 Cookie 的问题。 - Vary 头：默认错误序列化器现在会设置 `Vary` 头。 - OPTIONS 响应：修复了默认 OPTIONS 响应返回 204 的问题，改为返回 200 状态码，符合 RFC 7231 规定。 #### 3. 新功能 - bounded_stream 属性：新增 `falcon.Request.bounded_stream` 属性，用于替代 `stream` 属性，以解决部分 WSGI 服务器的阻塞问题。 - uri_template 属性：新增 `falcon.Request.uri_template` 属性，用于暴露请求路径对应的路由模板。 - Response 上下文属性：新增 `Response.context` 属性，与 `Request.context` 对齐。 - JSON 解码：新增 `get_param_as_dict()` 方法，支持一步完成 JSON 编码的查询参数解码。 - CSV 解析：支持禁用 CSV 样式的查询参数解析。 - 布尔值支持：`get_param_as_bool()` 现在支持 `on` 和 `off`，以兼容 IE 的默认复选框值。 - Accept-Ranges 属性：新增 `Response.accept_ranges` 属性，用于设置 `Accept-Ranges` 头。 - 新错误类：新增 `HTTPUriTooLong` 和 `HTTPGone` 错误类。 - 标题默认值：当未指定 `HTTPError` 标题时，现在默认使用 HTTP 状态文本。 - 可选参数：大多数错误类的参数现在都是可选的。 - Cookie 文档：澄清和扩展了与 Cookie 相关的文档。 #### 4. 性能优化 - JSON 处理：在 CPython 上，如果安装了 `ujson`，将使用 `ujson` 来加速错误序列化和查询字符串解析。 #### 5. 兼容性 - Jython 支持：Falcon 现在支持 Jython 2.7。 - Cookie 解析：修复了测试框架中解析 Cookie 时未去除空格的问题。 #### 6. 已知问题 - Cookie 解析：如果请求中的任意一个 Cookie 存在格式问题，当前版本会跳过所有 Cookie 的解析，改为仅跳过解析错误的 Cookie。 - 协议版本：在测试框架中模拟请求时，现在支持指定 HTTP 协议版本。 #### 7. 变更日志 - 1.4.0 版本更新： - 新功能：新增 `add_static_route()` 方法，支持从本地目录提供静态文件服务。 - JSON 处理：默认 JSON 处理器现在支持使用 `ujson` 加速。 - WebDAV 支持：新增对 WebDAV 方法（如 `UPDATE` 和 `REPORT`）的支持。 - Content-Disposition：新增 `downloadable_as` 属性，用于设置 `Content-Disposition` 头。 - 测试框架改进：`TestClient` 现在支持配置默认请求头。 - FAQ 扩展：重新组织并扩展了 FAQ 部分。 - 0.3.0 版本更新： - 新路由器架构：引入了新的路由器架构，提升性能和灵活性。 - 自定义路由器：支持在创建 API 实例时指定自定义路由器。 - URI 模板支持：支持在单个路径段中包含多个参数化字段。总结：Falcon v1.4.1 版本在错误处理、文档改进、测试框架优化、URI 处理、Cookie 支持等方面进行了多项改进和修复，同时新增了多项功能以提升开发体验和性能。