Django4全栈进阶之路5 Model模型

在 Django 中，模型（Model）是用于定义数据结构的组件，其作用如下：

定义数据结构：模型用于定义数据库中的表格和表格中的字段（列），其中每个模型类对应一个表格，模型中的每个字段对应表格中的一列。模型的定义可以在 models.py 文件中完成。
数据库操作：模型提供了简单易用的 API 用于操作数据库，包括创建、读取、更新和删除数据等。通过模型可以直接在数据库中执行 CRUD 操作，无需手动编写 SQL 语句。
数据验证：Django 中的模型还提供了强大的数据验证功能，可以在保存数据之前验证数据的完整性和有效性，确保数据的正确性。
ORM 框架：Django 的模型是基于 ORM（对象关系映射）框架实现的，可以轻松地在不同的数据库之间切换，同时也提供了方便的数据访问和查询功能，避免了直接编写 SQL 语句带来的繁琐和错误。

总的来说，模型是 Django 应用程序中最重要的组件之一，它负责定义数据结构、操作数据库、数据验证和 ORM 框架等方面的功能。通过模型的定义和使用，可以更加方便地管理应用程序中的数据，并且可以保证数据的正确性和安全性。

实例：

from django.db import models
from django.utils import timezone

class Repair(models.Model):
    # 报修单号，使用自增长的主键作为唯一标识
    id = models.AutoField(primary_key=True,verbose_name="报修编号")
    # 报修时间，使用默认值为当前时间
    date = models.DateTimeField(default=timezone.now,verbose_name="报修时间")
    # 报修人姓名，最大长度为50个字符
    name = models.CharField(max_length=50)
    # 报修人电话，最大长度为20个字符
    phone = models.CharField(max_length=20)
    # 报修内容，最大长度为200个字符
    content = models.CharField(max_length=200)
    # 报修状态，使用choices定义状态的可选值
    STATUS_CHOICES = [
        ('pending', '待处理'),
        ('processing', '处理中'),
        ('completed', '已完成'),
        ('canceled', '已取消')
    ]
    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending')
    created_at = models.DateTimeField(auto_now_add=True,verbose_name="创建时间")
    updated_at = models.DateTimeField(auto_now=True,verbose_name="更新时间")

    class Meta:
        verbose_name = "报修单"
        verbose_name_plural = "报修单"
        # 按照报修时间倒序排列
        ordering = ['-date']

    def __str__(self):
        # 返回报修单号和报修人姓名
        return f"{self.id} ({self.name})"

    def cancel(self):
        # 取消报修单
        self.status = 'canceled'
        self.save()

上述代码定义了一个名为 Repair 的模型，其中包含了报修单号、报修时间、报修人姓名、报修人电话、报修内容和报修状态等字段。该模型的属性和方法说明如下：

id：使用 AutoField 定义主键字段，作为唯一标识符。Django 4 中的模型（Model）类默认会自动为每个模型添加一个自增的整数类型主键字段，不需要显式地在模型中定义 id 字段。
date：使用 DateTimeField 定义报修时间字段，使用 timezone.now 设置默认值为当前时间。
name：使用 CharField 定义报修人姓名字段，设置最大长度为 50 个字符。
phone：使用 CharField 定义报修人电话字段，设置最大长度为 20 个字符。
content：使用 CharField 定义报修内容字段，设置最大长度为 200 个字符。
status：使用 CharField 定义报修状态字段，使用 choices 定义状态的可选值，设置默认值为 pending。
Meta：使用 Meta 类设置模型的元数据，包括排序方式等。在这里，我们将报修单按照报修时间的倒序排列。
__str__ 方法：使用 __str__ 方法返回报修单的字符串表示，方便在 Django 后台管理界面中查看。
cancel 方法：定义一个 cancel 方法，用于取消报修单，将状态设置为 canceled 并保存到数据库中。
使用了 verbose_name 和 verbose_name_plural 选项来分别设置模型的名称和复数形式。同时，我们也将所有字段的 verbose_name 设置为相应的汉字名称，以便在 Django 后台管理界面中更清晰地展示信息。
同时，我们增加了创建时间和更新时间字段，用于记录每条记录的创建时间和最后更新时间。created_at 字段使用了 auto_now_add=True 参数，表示在创建记录时自动设置为当前时间。updated_at 字段使用了 auto_now=True 参数，表示每次保存记录时都会自动更新为当前时间。