Django 3.1.x Documentation

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

摘要

Django 3.1.x文档详细阐述了Django框架的设计哲学，如松耦合、快速开发和DRY原则，并介绍了其稳定的API和后向兼容性承诺。文档还强调了安全性处理，指出安全问题可能导致向后兼容性破裂。此外，文档涵盖了数据库API的核心目标，并列出了新增和改进的功能，如缓存、表单、模型和数据库后端的更新。

AI总结

以下是《Django 3.1.x Documentation》的中文总结，重点突出核心观点和关键信息，并按照文档结构进行梳理：

---

### **核心功能概览**
1. **框架功能**：
- **内容处理**：支持条件内容处理。
- **内容类型与泛型关系**：用于关联不同模型的内容类型框架。
- **Flatpages**：简单的静态页面功能。
- **Redirects**：URL重定向工具。
- **Signals**：信号系统，支持应用之间的松耦合通信。
- **System check framework**：系统检查框架，帮助开发者发现配置或数据库问题。
- **The sites framework**：多站点支持框架。
- **Unicode支持**：从1.16版本开始增强Unicode支持。

2. **开发与社区**：
- **开源项目**：Django是一个开源项目，强调社区参与和贡献。
- **版本管理**：详细说明了版本号命名规则和弃用策略，确保向后兼容性。
- **安全政策**：优先修复安全漏洞，即使可能会破坏向后兼容性。

3. **API稳定性**：
- **稳定API**：文档中列出的功能（除内部实现）均为稳定API。
- **例外**：安全修复可能会破坏兼容性；内部API（以单下划线开头）可能随时更改。

---

### **设计哲学**
Django的设计基于以下核心理念：
1. **松耦合与高内聚**：各层之间尽量减少依赖。
2. **少代码**：减少重复代码，减轻开发负担。
3. **快速开发**：通过高效工具加速Web开发。
4. **DRY原则（Don’t Repeat Yourself）**：避免信息冗余，通过归一化减少重复。
5. **显式优于隐式**：避免“黑魔法”，优先使用清晰的代码。
6. **一致性**：在代码风格、API设计等方面保持一致。

### **具体功能设计**
1. **模型（Models）**：
- 行为基于明确的关键字参数，而非字段名称。
- 模型应封装领域逻辑，遵循Active Record模式。

2. **数据库API**：
- 设计目标包括灵活性、可扩展性和高效性。

---

### **新功能与更新**
1. **缓存**：
- 本地内存缓存使用LRU（Least Recently Used）策略。
- 新增`touch()`方法更新缓存键超时。

2. **表单**：
- `ImageField`小部件支持`accept="image/*"`属性。
- 新增`get_json_data()`方法以JSON格式返回表单错误。

3. **数据库与模型**：
- 支持PostgreSQL的范围索引和部分索引。
-新增` NullIf`和`Reverse`数据库函数。
- 批量创建时可设置`ignore_conflicts`参数忽略唯一性约束失败。

4. **管理命令**：
- `inspectdb`支持创建数据库视图和分区表模型。
- 新增`makemigrations --no-header`选项避免生成头部注释。
- `runserver`性能优化，支持Watchman监控文件变化。

5. **国际化与本地化**：
- 新增对亚美尼亚语言的支持。
- 未翻译的地区语言变体使用通用语言翻译。

6. **其他更新**：
- `OpenLayersWidget`升级到OpenLayers 4.6.5。
- 会话和CSRFcookies支持SameSite标志。
- 废弃了旧版本的`EnvironmentError`，分为`ImportError`和`RuntimeError`。

---

### **新手指引**
文档适合新手快速上手，涵盖：
- 设计数据库模型的快速入门指南。
- 数据模型语法示例，展示如何定义 Reporter 和 Article 模型。

---

### **总结**
Django 3.1.x文档详细介绍了框架的核心功能、设计理念、版本更新和新手指引。其核心目的是通过松耦合、快速开发和DRY原则等设计哲学，帮助开发者高效构建Web应用，同时通过稳定API和完善的社区支持，确保项目的可维护性和扩展性。