Django4全栈进阶之路3 Model模型

发布时间 2023-04-23 17:49:45作者: 城南城南

在 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 模型的一个示例来参考。需要注意的是,这只是一个示例,实际项目中