Django 模型（model）

重新复习一下,好多年没碰了.都快忘光了..

 https://blog.csdn.net/weixin_51550438/article/details/124669218

 

 

from django.db import models
 
#定义图书模型类Book
class Book(models.Model):
    btitle = models.CharField(max_length=20, verbose_name='名称')
    bpub_date = models.DateField(verbose_name='发布日期')
    bread = models.IntegerField(default=0, verbose_name='阅读量')
    bcomment = models.IntegerField(default=0, verbose_name='评论量')
    is_delete = models.BooleanField(default=False, verbose_name='逻辑删除')
 
    class Meta:
        db_table = 'tb_books'  # 指明数据库表名
        verbose_name = '图书'  # 在admin站点中显示的名称
        verbose_name_plural = verbose_name  # 显示的复数名称
 
    def __str__(self):
        """定义每个数据对象的显示信息"""
        return self.Book

　　

python manage.py makemigrations TestModel  # 让 Django 知道我们在我们的模型有一些变更
python manage.py migrate TestModel   # 创建表结构

　　

数据库表名
模型类如果未指明表名，django默认以小写app名_小写模型类名为数据库表名

可以通过db_table指明数据库表名

关于主键
django会为表创建自动增长的主键列

默认创建的主键列属性为id，可以使用pk（primary key）代替

属性命名限制
不能是python的保留关键字

不允许使用连续的下划线，这是由django的查询方式决定的

定义属性时需要指定字段类型，通过字段类型的参数指定选项

字段类型

类型 备注
AutoField int自增列，必须填入参数 primary_key=True。当model中如果没有自增列，则自动会创建一个列名为id的列。
Booleanfield 布尔字段，值为True或False
NullBooleanField 支持Null、True、False三种值
CharField 字符类型，必须提供max_length参数， max_length表示字符长度。
TextField 大文本字段，一般超过4000个字符时使用
IntegerField 一个整数类型,范围在 -2147483648 to 2147483647。
Decimalfield 十进制浮点数 ， 参数maxdigits表示总位数， 参数decimalplaces表示小数位数
FloatField 浮点数
DateField 日期字段，日期格式 YYYY-MM-DD，相当于Python中的datetime.date()实例。
TimeField 时间，参数同date
DateTimeField 日期时间字段，格式 YYYY-MM-DD HH:MM:ss[.uuuuuu]，相当于Python中的datetime.datetime()实例。
FileField 上传文件字段
imageField 继承于FileField，对上传的 内容进⾏行行校验，确保是有效的图⽚片(必须要安装Pillow才可以使用（pip install Pillow）

 

• 选项（参数）

  选项 备注
  null 如果为True，表示允许为空，默认值是False
  blank 如果为True，则该字段允许为空白，默认值是False
  db_column 字段的名称，如果未指定，则使用属性的名称
  db_index 若值为True, 则在表中会为此字段创建索引，默认值是False
  default 默认
  primary_key 若为True，则该字段会成为模型的主键字段，默认值是False，一般作为AutoField的选项使用
  unique 如果为True, 这个字段在表中必须有唯一值，默认值是False
  auto_now_add
  （时间字段独有） 配置auto_now_add=True，创建数据记录的时候会把当前时间添加到数据库。
  auto_now
  （时间字段独有）

  配置上auto_now=True，每次更新数据记录的时候会更新该字段。

外键
在设置外键时，需要通过in_delete选项指明主表删除数据时，对于外键引用好数据如何处理，在django.db.models中包含了可选常量，

on_delete：当删除关联表中的数据时，当前表与其关联的行的行为。

例如：

blog = models.OneToOneField(xx, on_delete=models.CASCADE)

 

外键

备注
models.CASCADE 删除关联数据，与之关联也删除
models.DO_NOTHING 删除关联数据，引发错误IntegrityError
models.PROTECT 删除关联数据，引发错误ProtectedError
models.SET_NULL 删除关联数据，与之关联的值设置为null（前提FK字段需要设置为可空）
models.SET_DEFAULT 删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值）
models.SET
删除关联数据，

a. 与之关联的值设置为指定值，设置：models.SET(值)

b. 与之关联的值设置为可执行对象的返回值，设置：models.SET(可执行对象)

db_constraint
是否在数据库中创建外键约束，默认为True。

一对多、一对一、多对多
ForeignKey：通常一对多字段用来扩展已有字段。
外键类型在ORM中用来表示外键关联关系，一般把ForeignKey字段设置在 '一对多'中'多'的一方。

ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系。

例如：

class Classes(models.Model):
    name = models.CharField(max_length=32)
 
class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes")
 
#当我们要查询某个班级关联的所有学生（反向查询）时，我们会这么写：
 
models.Classes.objects.first().student_set.all()
 
#当我们在ForeignKey字段中添加了参数 related_name 后，
 
class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes", related_name="students")
 
#当我们要查询某个班级关联的所有学生（反向查询）时，我们会这么写：
 
models.Classes.objects.first().students.all()

　　

 OneToOneField：通常一对一字段用来扩展已有字段。

一对一的关联关系多用在当一张表的不同字段查询频次差距过大的情况下，将本可以存储在一张表的字段拆开放置在两张表中，然后将两张表建立一对一的关联关系。如代码所示"作者"和“作者信息”的关系；

class Author(models.Model):
    name = models.CharField(max_length=32)
    info = models.OneToOneField(to='AuthorInfo')
    
 
class AuthorInfo(models.Model):
    phone = models.CharField(max_length=11)
    email = models.EmailField()

　　

字段参数	备注
to	设置要关联的表。
to_field	设置要关联的字段。
on_delete	同ForeignKey字段

 

 ManyToManyField：用于表示多对多的关联关系。在数据库中通过第三张表来建立关联关系。

举个例子：

class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self")
 
#此时，person对象就没有person_set属性。
 
class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self", symmetrical=False)
 
#仅用于多对多自关联时，指定内部是否创建反向操作的字段。默认为True。

　　

字段参数 备注
to 设置要关联的表。
related_name

同ForeignKey字段。
related_query_name

同ForeignKey字段。
symmetrical

仅用于多对多自关联时，指定内部是否创建反向操作的字段。默认为True。

through

在使用ManyToManyField字段时，Django将自动生成一张表来管理多对多的关联关系。

但我们也可以手动创建第三张表来管理多对多关系，此时就需要通过through来指定第三张表的表名。

through_fields

设置关联的字段。
db_table

默认创建第三张表时，数据库中表的名称。

 

多对多关联关系的三种方式

方式一：自行创建第三张表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
 
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
 
 
# 自己创建第三张表，分别通过外键关联书和作者
class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")
 
    class Meta:
        unique_together = ("author", "book")

　　

方式二：通过ManyToManyField自动创建第三张表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
 
# 通过ORM自带的ManyToManyField自动创建第三张表
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", related_name="authors")

　　

方式三：设置ManyTomanyField并指定自行创建的第三张表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
 
# 自己创建第三张表，并通过ManyToManyField指定关联
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", through="Author2Book", through_fields=("author", "book"))
    # through_fields接受一个2元组（'field1'，'field2'）：
    # 其中field1是定义ManyToManyField的模型外键的名（author），field2是关联目标模型（book）的外键名。
 
 
class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")
 
    class Meta:
        unique_together = ("author", "book")

　　

元信息
ORM对应的类里面包含另一个Meta类，而Meta类封装了一些数据库的信息。主要字段如下:

db_table
ORM在数据库中的表名默认是 app_类名，可以通过db_table可以重写表名。

index_together
联合索引。

unique_together
联合唯一索引。

ordering
指定默认按什么字段排序。

只有设置了该属性，我们查询到的结果才可以被reverse()。