Django4全栈进阶之路3 Model模型

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

1. 定义数据结构：模型用于定义数据库中的表格和表格中的字段（列），其中每个模型类对应一个表格，模型中的每个字段对应表格中的一列。模型的定义可以在 models.py 文件中完成。

2. 数据库操作：模型提供了简单易用的 API 用于操作数据库，包括创建、读取、更新和删除数据等。通过模型可以直接在数据库中执行 CRUD 操作，无需手动编写 SQL 语句。

3. 数据验证：Django 中的模型还提供了强大的数据验证功能，可以在保存数据之前验证数据的完整性和有效性，确保数据的正确性。

4. 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 参数，表示每次保存记录时都会自动更新为当前时间。

以上是一个简单的报修表的模型定义，可以作为 Django 模型的一个示例来参考。需要注意的是，这只是一个示例，实际项目中