Django 2.1.x Documentation

• 语言: 英语
• 格式: .pdf
• 来源: media.readthedocs.org

摘要

文档主要阐述了Django 2.1.x版本的稳定性和设计哲学。内容涵盖了API的稳定性保障、安全修复处理方式、数据库层的修改等。此外，还介绍了设计理念如松耦合、DRY（不要重复自己）、显式优于隐式，以及模型和数据库API的核心目标。新功能包括FileResponse、json_script筛选器、测试客户端的增强以及对MySQL、PostgreSQL版本的支持更新。

AI总结

以下是对文档内容的总结，语言简洁明了，重点突出核心观点和关键信息：

---

### 1. **稳定API与兼容性**
- **稳定API**：文档中大部分内容（除内部区域）均被视为稳定API，仅在安全或关键错误情况下才会破坏向后兼容性。
- **例外情况**：
- 安全修复：若发现安全问题，将优先修复，可能破坏兼容性。
- 内部API：明确标记为“内部”的API（如前缀为`_`的函数）可能随时更改。

### 2. **设计理念**
- **松耦合与高内聚**：框架各层尽量独立，减少互相依赖。
- **减少代码**：倾向于简洁，利用Python动态特性，减少样板代码。
- **快速开发**：目标是加速Web开发，避免冗余。
- **DRY原则**：数据与概念单一存储，避免重复。
- **显式优于隐式**：避免过多“魔法”，明确行为。
- **一致性**：在代码风格、高级功能等方面保持一致。

### 3. **新功能与改进**
- **模板**：新增`json_script`过滤器，安全输出JSON对象。
- **文件响应**：新增`as_attachment`参数，支持文件下载。
- **测试客户端**：支持307和308重定向，JSON请求数据序列化。
- **消息框架**：支持临时消息存储。
- **管理命令**：新增`loaddata --exclude`选项，支持排除模型或应用。
- **模型**：支持`callable`默认值，新增图片扩展验证。

### 4. **更改与移除**
- **数据库后端API**：多项修改，如异常类型更改、API返回值调整。
- **移除支持**：删除对SpatiaLite 4.0、MySQL 5.5和PostgreSQL 9.3的支持。
- **管理命令**：新增`diffsettings --default`选项。

### 5. **开发流程与版本发布**
- **代码仓库**：包括功能分支、标签、attic中的旧功能分支等。
- **发布步骤**：
1. 安全发布：提前.notify安全团队。
2. 更新版本号，生成包并上传。
3.发布说明与公告。

---

以上为文档的核心内容总结，重点突出关键信息，逻辑清晰，语言简明。