models中integer、char、Boolean、text、datetime字段类型的常用参数设置

from django.db import models

# Create your models here.
# 1.创建数据表People
# 2.创建用户名、年龄、性别字段
#      varchar、integer、bool


class People(models.Model):
    """
    1、必须继承Model或者Model子类
    2、一个ORM模型类就对应了一个数据库中的一张表
    3、在ORM模型类中定义类属性，并且类属性必须是Field的子类，与数据表中的字段对应
    4、CharField类与mysql中的varchar对应，并且必须得指定max_length参数（指定当前字段的最大字节数）
    5、IntegerField类与mysql中integer对应为整型
    6、ORM模型类会自动创建一个名为id的自增主键（非空、唯一），且为integer类型
    7、生成迁移脚本
        a.python manage.py makemigrations 子应用名称
        b.如果不指定子应用名称，那么会将所有子应用（包括内置）根据models.py文件生成迁移脚本
    8、生成迁移脚本，并不会创建表，只有执行迁移脚本之后，才会创建表
        a.python manage.py migrate 子应用名称
        b.如果不指定子应用名称，那么会执行所有子应用（包括内置）的migrations包中的迁移脚本
    9、生成表的名称默认为子应用名_模型类名小写
    10、打印迁移脚本生成的sql语句
        python manage.py sqlmigrate 子应用名称 迁移脚本名（不包括后缀“.py”）
    """
    username1 = models.CharField(max_length=20)
    age = models.IntegerField()
    gender = models.BooleanField(default=True)


class Project(models.Model):
    # a.如果ORM模型类中某个字段指定了primary_key=True，那么ORM框架就不会自动生成名称为id的自增主键
    # b.会把指定了primary_key=True的字段作为主键
    # c.创建的ORM模型类中字段默认primary_key=False，为非主键字段
    # d.verbose_name和help_text指定当前字段的描述信息，一般在api接口文档平台、后台管理站点、前端渲染的表单中会显示
    # 区别
    # verbose_name主要用于提供字段的人类可读名称，改善字段的显示效果。
    # help_text则用于提供字段的额外说明或帮助信息，增加字段的可理解性。
    # 总的来说，这两个参数都是为了提高模型字段在管理后台和表单中的可用性和友好性。
    # verbose_name关注于如何命名字段，而help_text关注于如何解释字段。
    id = models.IntegerField(primary_key=True, verbose_name="id主键", help_text='为id主键字段')
    # e.使用unique=True为当前字段指定唯一约束，默认创建的ORM模型类字段unique=False（可重复）
    name = models.CharField(verbose_name='项目名称', help_text='输入项目名称', unique=True,
                            max_length=50)
    # f.使用null=True，指定当前字段在数据库中是否可以存储NULL值，默认该字段在数据库中必须有一个值
    leader = models.CharField(verbose_name='项目负责人', help_text='输入项目负责人',
                              max_length=20, null=True)
    # g.使用default=True，为当前字段指定默认值，指定默认值之后，前端创建数据时，如果不指定该字段，那么会自动将默认值作为当前字段的值
    is_execute = models.BooleanField(verbose_name='是否启动项目', help_text='请选择是否启动项目',
                                     default=True)
    # h.使用blank=True，指定前端在创建数据时，可以不用传递该字段（在后面序列化器类中使用），默认前端在创建数据时，必须传递该字段
    # 指定字段在表单验证时是否可以为空，如果blank=True，则该字段在表单验证时允许为空
    # 如果blank=False（默认值），则该字段在表单验证时必须有一个值
    desc = models.TextField(verbose_name='项目描述', help_text='输入项目描述',
                            null=True, blank=True)
    # i.可以为DateTimeField、DateField字段添加auto_now_add、auto_now参数
    #   》auto_now_add=True指定在创建该记录时，会自动将当前创建的时间作为该字段的值，后续不会变更
    #   》auto_now=True在每次更新该记录时，会自动将当前更新的时间作为该字段的值，后续只要更新了该记录，都会自动修改
    #   》auto_now_add和auto_now不能同时指定
    create_time = models.DateTimeField(verbose_name='创建时间', help_text='这是创建时间，会自动设置',
                                       auto_now_add=True)
    update_time = models.DateTimeField(verbose_name='修改时间', help_text='这是修改时间，每次数据改变时会自动更新',
                                       auto_now=True)

    class Meta:
        db_table = 'tb_project'
        verbose_name = '项目表'
        verbose_name_plural = '项目表'
        ordering = ['id']
        # ordering = ['-id', 'name', '?leader']