[Python]Django 模型

---

🍉 前言

系列文章目录
[Python]目录

---

文章目录

• 🍉 前言
• 🍉 Django 模型
• 🍉 定义模型
• • 🥝 语法
  • 🥝 常用模型字段类型
  • • 🥑 AutoField
    • 🥑 BooleanField
    • 🥑 NullBooleanField
    • 🥑 CharField
    • 🥑 DateField
    • 🥑 DateTimeField
    • 🥑 TimeField
    • 🥑 IntegerField
    • 🥑 TextField
    • 🥑 FloatField
    • 🥑 FileField
    • 🥑 ImageField
    • 🥑 DecimalField
  • 🥝 常用字段参数
  • 🥝 代码示例--定义模型类
  • • 🥑 UserBaseInfo
    • 🥑 UserExtraInfo
    • 🥑 DepartInfo
    • 🥑 SkillInfo
  • 🥝 `__str__()`方法
  • • 🥑 代码示例
  • 🥝 Meta 类
  • • 🥑 代码示例
• 🍉 模型的关系
• • 🥝 一对一
  • • 🥑 代码示例
  • 🥝 一对多
  • • 🥑 代码示例
  • 🥝 多对多
  • • 🥑 代码示例
• 🍉 迁移数据在数据库生成表
• • 🥝 生成迁移文件
  • 🥝 执行迁移
  • 🥝 之前迁移过程截图

---

🍉 Django 模型

Django 框架中，模型用于实现与数据库的交互，如数据的增删改查等。

在 Django 框架中，模型用于描述数据库表结构，一个模型(Model)对应一个数据表，模型中的字段对应数据表中的一个字段，一个模型对象对应数据表中的一条记录。

🍉 定义模型

所有的 Django 模型必须继承 Model 类，Model 类位于包 django.db.models 中。

🥝 语法

from django.db.models import Model


class 模型名(Model):
    字段
    其他属性或方法
    ...
1
2
3
4
5
6
7

🥝 常用模型字段类型

🥑 AutoField

数据库中的自动增长类型，相当于自动增长的IntegerField类型字段，对应MySQL中的int类型，可以用于ID的自动增长。

通常我们不需要设置该类型的ID字段，因为如果没有指定，django会为表创建自动增长的主键列，每个模型只能有一个主键列，如果使用选项设置某属性为主键列后django不会再创建自动增长的主键列。

🥑 BooleanField

一个真/假(True/False)的布尔类型字段，对应MySQL中的tinyint类型。

该类型的字段如果没有设置默认值，则该字段的默认值为None。

该类型的字段默认对应CheckboxInput表单部件。

🥑 NullBooleanField

支持Null、True、False三种值。

🥑 CharField

字符类型字段，对应MySQL中的varchar类型。

该类型的字段必须设置字符的最大个数，即必须设置max_length参数。

该类型的字段默认对应TextInput表单部件。

🥑 DateField

日期字段，对应MySQL中的date类型。

该类型的字段默认对应DateInput表单部件。

对于 DateField 字段，有auto_now_add、auto_now两个参数：
1.auto_now_add：
该参数的默认值为False，如果将该参数的值设置为True，则会自动将该字段的值设置为创建时的时间，后期不能再次修改，且无法手动为该字段赋值。
该参数可以用于记录用户注册时间的字段。
2.auto_now：
该参数的默认值为False，如果将该参数的值设置为True，则会自动将该字段的值设置为当前的时间，且无法手动为该字段赋值。
该参数可以用于记录用户登录时间的字段。

注意：auto_now_add、auto_now和default选项是相互排斥的。这些选项的任何组合都会导致错误。如果将 auto_now 或 auto_now_add 设置为 True，将导致该字段设置为 editable=False(设置为不可手动编辑) 和 blank=True(不允许为空)。

🥑 DateTimeField

日期时间类型字段，对应MySQL中的datetime类型。

DateTimeField类型的字段和DateField类型的字段一样，有auto_now_add、auto_now两个参数，且用法相同。

🥑 TimeField

时间类型字段，对应MySQL中的time类型。

TimeField类型的字段和DateField类型的字段一样，有auto_now_add、auto_now两个参数，且用法相同。

🥑 IntegerField

整数类型字段，对应MySQL中的int类型。

该类型的字段的取值范围为 -2147483648 到 2147483647 ，如果取值在该范围内，则在 Django 支持的所有数据库中都是安全的。

🥑 TextField

长文本类型字段，对应MySQL中的longtext类型。

该字段的默认表单部件是一个 Textarea。该类型的字段如果指定了 max_length 属性，则 max_length 属性将会反映在自动生成的表单字段的 Textarea 部件中。

🥑 FloatField

浮点数类型字段，对应MySQL中的double类型。

FloatField 类有时会与 DecimalField 类混淆。它们都表示实数，但它们表示的方式不同。FloatField 内部使用 Python 的 float 类型，而 DecimalField 则使用 Python 的 Decimal 类型。

🥑 FileField

字符类型字段，对应MySQL中的varchar类型。

🥑 ImageField

字符类型字段，对应MySQL中的varchar类型。

🥑 DecimalField

数值型类型字段，对应MySQL中的decimal类型。

该类型字段表示固定精度的十进制。

有两个必要的参数：
1.DecimalField.max_digits：数字中允许的最大位数。注意，这个数字必须大于或等于 decimal_places。
2.DecimalField.decimal_places：与数字一起存储的小数位数。

🥝 常用字段参数

null是数据库范畴的概念，blank是表单验证范畴的概念

🥝 代码示例–定义模型类

导入 models 模块：

from django.db import models
1

🥑 UserBaseInfo

class UserBaseInfo(models.Model):
    """
    用户基本信息表
    """
    id = models.AutoField(verbose_name='编号', primary_key=True)
    username = models.CharField(verbose_name='用户名', max_length=30)
    password = models.CharField(verbose_name='密码', max_length=20)
    status = models.CharField(verbose_name='状态', max_length=1)
    # 指定在数据库表中字段的名称为createDate，且自动将该字段的值设置为创建时的时间后期不能再次修改，不能手动为该字段赋值
    createdate = models.DateTimeField(verbose_name='创建时间', db_column='createDate', auto_now_add=True)
1
2
3
4
5
6
7
8
9
10

🥑 UserExtraInfo

class UserExtraInfo(models.Model):
    """
    用户扩展信息表
    """
    id = models.AutoField(verbose_name='编号', primary_key=True)
    username = models.CharField(verbose_name='用户名', max_length=30)
    password = models.CharField(verbose_name='密码', max_length=20)
    sex = models.CharField(verbose_name='性别', max_length=1, default='male')
    salary = models.DecimalField(verbose_name='工资', max_digits=8, decimal_places=2)  # 最大位数8位，其中小数2位
    birthday = models.DateField(verbose_name='出生日期')
    age = models.IntegerField(verbose_name='年龄', default=0)
    email = models.CharField(verbose_name='邮箱', max_length=30, blank=True)  # 允许为空，为空时数据库中存储的数据为空字符串
    status = models.CharField(verbose_name='状态', max_length=1)
    createdate = models.DateTimeField(verbose_name='创建时间', db_column='createDate', auto_now_add=True)
1
2
3
4
5
6
7
8
9
10
11
12
13
14

🥑 DepartInfo

class DepartInfo(models.Model):
    """
    部门信息表
    """
    id = models.AutoField(verbose_name='编号', primary_key=True)
    departname = models.CharField(verbose_name='部门名称', max_length=20)
    createdate = models.DateTimeField(verbose_name='创建时间', db_column='createDate', auto_now_add=True)
1
2
3
4
5
6
7

🥑 SkillInfo

class SkillInfo(models.Model):
	"""
    员工技能表
    """
    id = models.AutoField(verbose_name='编号', primary_key=True)
    skillname = models.CharField(verbose_name='技能名称', db_column='skillName', max_length=20)
    createdate = models.DateTimeField(verbose_name='创建时间', db_column='createDate', auto_now_add=True)
1
2
3
4
5
6
7

🥝 __str__()方法

__str__()方法用于设置输出模型对象时的返回值，默认的返回值为模型对象，可以通过__str__()方法设置打印模型对象的返回值。

注意：__str__()方法只允许返回字符类型的字段，如果要返回其他类型的字段，需要使用str()函数将字段的值转换为字符类型。

🥑 代码示例

class UserBaseInfo(models.Model):
    """
    用户基本信息表
    """
    ......
    
    def __str__(self):
        # 由于`__str__()`方法只允许返回字符类型的字段，所以对于整数类型的id字段需要使用str()函数将字段的值转换为字符类型
        return str(self.id) + ': ' + '用户名-' + self.username + '\t用户状态-' + self.status


class UserExtraInfo(models.Model):
    """
    用户扩展信息表
    """
    ......
    
    def __str__(self):
        return str(self.id) + ': ' + '用户名-' + self.username + '\t用户状态-' + self.status


class DepartInfo(models.Model):
    """
    部门信息表
    """
    ......
    
    def __str__(self):
        return str(self.id) + ': ' + '部门名称-' + self.departname


class SkillInfo(models.Model):
	"""
    员工技能表
    """
    ......
    
    def __str__(self):
        return str(self.id) + ': ' + '技能名称-' + self.departname
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

测试：

from subapp01.models import UserBaseInfo, UserExtraInfo, DepartInfo, SkillInfo  # 导入模型类型
from django.http import HttpResponse  # 导入返回响应的类


# Create your views here.
def fun(request):
    users = UserBaseInfo.objects.all()  # 获取userbaseinfo表中的所有记录
    for user in users:  # 循环遍历打印userbaseinfo表中的所有用户信息记录对象
        print(user)  # str(self.id) + ': ' + '用户名-' + self.username + '\t用户状态-' + self.status

    return HttpResponse(users)  # 向客户端返回响应
1
2
3
4
5
6
7
8
9
10
11

🥝 Meta 类

Django 模型中的 Meta 类是一个内部类，用于定义一些 Django 模型的行为特性。

Meta 类的常用参数：

🥑 代码示例

class UserBaseInfo(models.Model):
    """
    用户基本信息表
    """
    ......

    def __str__(self):
        ......

    class Meta:
        db_table = 'user_base_info'  # 在数据库中该模型对应的表的名称
        verbose_name = '用户基本信息表'  # 模型类在后台管理中显示的名称
1
2
3
4
5
6
7
8
9
10
11
12

🍉 模型的关系

数据库中的表存在一对一、一对多、多对多的关联关系，Django中的模型对应数据库中的表，所以，Django中的模型也存在一对一、一对多、多对多的关联关系。

🥝 一对一

建立Django模型之间一对一的关联关系，在模型中使用models模块下OneToOneField()方法来构建模型的一对一关联关系。

使用OneToOneField()方法来构建模型间的一对一关联关系，相当于在模型中创建了一个引用另一个模型指定字段的外键。

哪个数据表需要外键，就把OneToOneField()方法放到该数据表对应的模型中。

models模块下OneToOneField()方法的参数：

on_delete参数的配置选项：

🥑 代码示例

用户基本信息表UserBaseInfo和用户扩展信息表UserExtraInfo之间的关系为一对一的关系，由于在用户基本信息表中需要建立外键关联用户扩展信息表中的数据记录，所以在用户基本信息表对应的模型中使用OneToOneField()方法建立外键关联用户扩展信息表的数据记录。

class UserExtraInfo(models.Model):
	"""
    用户扩展信息表
    """
    ......

class UserBaseInfo(models.Model):
    """
    用户基本信息表
    """
    ......
    # 设置外键，关联用户扩展信息表，且用户扩展信息表数据删除时进行级联操作删除基本信息表的信息，该字段允许为空
    # 自动关联用户扩展信息表的主键
    user = models.OneToOneField(to=UserExtraInfo, on_delete=models.CASCADE, null=True)

    def __str__(self):
        ......

    class Meta:
        ......
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

🥝 一对多

建立Django模型之间一对多的关联关系，在模型中使用models模块下ForeignKey()方法来构建模型间的一对多关联关系。

通常把ForeignKey()方法放到“多”的数据表对应的模型中，即在“多”对应的模型中建立引用“一”对应的模型中字段数据的外键。

ForeignKey()方法的参数：

🥑 代码示例

用户扩展信息表UserExtraInfo和部门信息表DepartInfo之间的关系为多对一的关系，由于在用户扩展信息表中需要建立外键关联部门信息表，所以在用户扩展信息表对应的模型中使用ForeignKey()方法建立外键关联部门信息表。

class DepartInfo(models.Model):
    """
    部门信息表
    """
    ......


class UserExtraInfo(models.Model):
    """
    用户扩展信息表
    """
    ......
    depart = models.ForeignKey(
        to=DepartInfo,  # 关联的模型为部门信息模型DepartInfo
        null=True,  # 该字段允许为空
        on_delete=models.SET_NULL,  # 当部门信息表的记录删除时将该表的相关数据的相关字段设置为null
        related_name='user_extra_info',  # 当进行反向操作时，使用user_extra_info代表该模型
        db_constraint=True  # 在数据库中建立外键约束
    )

    def __str__(self):
        ......
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

🥝 多对多

建立Django模型之间多对多的关联关系，在模型中使用models模块下ManyToManyField()方法来构建模型间的多对多关联关系。

对于使用ManyToManyField()方法建立模型之间的多对多关系，该方法放在哪个模型并没有什么区别，因为通过ManyToManyField()方法建立模型之间的多对多关系，会在数据库中生成一个关联两个模型对应的数据表的第三张表。

ManyToManyField()方法的参数：

🥑 代码示例

用户扩展信息表UserExtraInfo和用户技能表SkillInfo之间的关系为多对多的关系，使用ManyToManyField()方法建立两个模型之间的多对多关联。

class SkillInfo(models.Model):
    """
    用户技能表
    """
    ......


class UserExtraInfo(models.Model):
    """
    用户扩展信息表
    """
    ......
    # 建立该模型与用户技能模型之间的多对多关联关系，在数据库中创建外键约束，用于关联两个模型对应表的第三表的表名为user_skill
    skill = models.ManyToManyField(to=SkillInfo, db_constraint=True, db_table='user_skill')

    def __str__(self):
        ......
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

🍉 迁移数据在数据库生成表

🥝 生成迁移文件

在迁移数据之前，首先要生成迁移文件。

生成所有子应用迁移文件的命令：

python manage.py makemigrations
1

在此之前已有进行数据迁移，所以在这迁移的为修改后的内容

🥝 执行迁移

执行迁移，在数据库中创建对应的表，将数据同步到数据库中。

在第一次进行迁移时，数据库中不能存在同名的数据表，否则会迁移失败

执行迁移的命令：

python manage.py migrate
1

🥝 之前迁移过程截图

生成迁移文件

python manage.py makemigrations
1

如果报错：
No changes detected

原因：可能子应用没有进行注册

数据迁移同步到数据库中

python manage.py migrate
1