10)django-ORM(创建，字段类型，字段参数)

一：ORM关系对象映射（Object Relational Mapping，简称ORM）

ORM分两种：

　　DB first 先在数据库中创建数据库表等
　　Code first 先创建类，然后根据类创建数据表等。django中遵循 Code Frist 的原则，即：根据代码中定义的类来自动生成数据库表。

二：Django ORM创建

　　1）创建类

　　创建的类必须继承models.Model,在数据库中自动创建表名为：app名_表名，如：app01_userinfo

    from django.db import models

    # Create your models here.
    #表名app01_userinfo
    class UserInfo(models.Model):
        #默认有id列，还是主键
        username=models.CharField(max_length=32)
        password=models.CharField(max_length=32)

　　2）注册APP

　　

    B)注册APP
        INSTALLED_APPS = [
            'django.contrib.admin',
            'django.contrib.auth',
            'django.contrib.contenttypes',
            'django.contrib.sessions',
            'django.contrib.messages',
            'django.contrib.staticfiles',
            'app01',#注册APP，上面都是默认值
        ]

　　3）配置数据库，默认是sqllite,可以修改为mysql等

　　　　A)sqllte配置

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

　　　　B)mysql配置

　　

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '',
    }
}  

　　　　C)注意事项

　　　　django默认使用的是MySQLdb模块链接Mysql
        　　python3使用的是pymysql,主动修改为pymysql:在project同名文件来下的_init__.py(settings一起的目录)中添加如下代码：

   import pymysql
   pymysql.install_as_Mysqldb()

　　4）  生成数据表

　　

        python manage.py makemigrations  #生成sql

        python manage.py migrate  #数据库中生成表等

　　5）注意事项

　　　　A)找到app下的models.py不要改名字，改了django就不到了

　　　　B）增加字段

　　

    class UserInfo(models.Model):
        username=models.CharField(max_length=20)
        password=models.CharField(max_length=3)

    1）字段长度变短
        password=models.CharField(max_length=32)
        password=models.CharField(max_length=30)
        数据超过长度就丢了

        “
            alex    1234567    查看 编辑 删除
        “
    2）增加字段，字段默认不允许为空。需要设置默认值，或者设置字段允许为空

        class UserInfo(models.Model):
            username=models.CharField(max_length=20)
            password=models.CharField(max_length=3)
            email=models.CharField(max_length=30)
    下面没有设置default,null
    python manage.py makemigrations
    提示：
        E:\Django项目练习\d19new>python manage.py makemigrations
    You are trying to add a non-nullable field 'email' to userinfo without a default; we can't do that (the database needs something to populate existing rows).
    Please select a fix:
     1) Provide a one-off default now (will be set on all existing rows with a null value for this column)
     2) Quit, and let me add a default in models.py
    Select an option:

    字段默认不允许为空。需要设置默认值，或者设置字段允许为空
    email=models.CharField(max_length=30,null=True)

    3） test=models.EmailField(max_length=19)#create不会验证，EmailField是给django admin验证使用，还有其他比如URLField等

    4)自曾ID
    如果用AutoField(primary_key=True)，就不会使用默认id

三：字段类型

　　

AutoField(Field)
        - int自增列，必须填入参数 primary_key=True

    BigAutoField(AutoField)
        - bigint自增列，必须填入参数 primary_key=True

        注：当model中如果没有自增列，则自动会创建一个列名为id的列
        from django.db import models

        class UserInfo(models.Model):
            # 自动创建一个列名为id的且为自增的整数列
            username = models.CharField(max_length=32)

        class Group(models.Model):
            # 自定义自增列
            nid = models.AutoField(primary_key=True)
            name = models.CharField(max_length=32)

    SmallIntegerField(IntegerField):
        - 小整数 -32768 ～ 32767

    PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正小整数 0 ～ 32767
    IntegerField(Field)
        - 整数列(有符号的) -2147483648 ～ 2147483647

    PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正整数 0 ～ 2147483647

    BigIntegerField(IntegerField):
        - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807

    自定义无符号整数字段

        class UnsignedIntegerField(models.IntegerField):
            def db_type(self, connection):
                return 'integer UNSIGNED'

        PS: 返回值为字段在数据库中的属性，Django字段默认的值为：
            'AutoField': 'integer AUTO_INCREMENT',
            'BigAutoField': 'bigint AUTO_INCREMENT',
            'BinaryField': 'longblob',
            'BooleanField': 'bool',
            'CharField': 'varchar(%(max_length)s)',
            'CommaSeparatedIntegerField': 'varchar(%(max_length)s)',
            'DateField': 'date',
            'DateTimeField': 'datetime',
            'DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)',
            'DurationField': 'bigint',
            'FileField': 'varchar(%(max_length)s)',
            'FilePathField': 'varchar(%(max_length)s)',
            'FloatField': 'double precision',
            'IntegerField': 'integer',
            'BigIntegerField': 'bigint',
            'IPAddressField': 'char(15)',
            'GenericIPAddressField': 'char(39)',
            'NullBooleanField': 'bool',
            'OneToOneField': 'integer',
            'PositiveIntegerField': 'integer UNSIGNED',
            'PositiveSmallIntegerField': 'smallint UNSIGNED',
            'SlugField': 'varchar(%(max_length)s)',
            'SmallIntegerField': 'smallint',
            'TextField': 'longtext',
            'TimeField': 'time',
            'UUIDField': 'char(32)',

    BooleanField(Field)
        - 布尔值类型

    NullBooleanField(Field):
        - 可以为空的布尔值

    CharField(Field)
        - 字符类型
        - 必须提供max_length参数， max_length表示字符长度

    TextField(Field)
        - 文本类型

    EmailField(CharField)：
        - 字符串类型，Django Admin以及ModelForm中提供验证机制

    IPAddressField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制

    GenericIPAddressField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
        - 参数：
            protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
            unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启刺功能，需要protocol="both"

    URLField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证 URL

    SlugField(CharField)
        - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）

    CommaSeparatedIntegerField(CharField)
        - 字符串类型，格式必须为逗号分割的数字

    UUIDField(Field)
        - 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证

    FilePathField(Field)
        - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
        - 参数：
                path,                      文件夹路径
                match=None,                正则匹配
                recursive=False,           递归下面的文件夹
                allow_files=True,          允许文件
                allow_folders=False,       允许文件夹

    FileField(Field)
        - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认django.core.files.storage.FileSystemStorage

    ImageField(FileField)
        - 字符串，路径保存在数据库，文件上传到指定目录
        - 参数：
            upload_to = ""      上传文件的保存路径
            storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
            width_field=None,   上传图片的高度保存的数据库字段名（字符串）
            height_field=None   上传图片的宽度保存的数据库字段名（字符串）

    DateTimeField(DateField)
        - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]

    DateField(DateTimeCheckMixin, Field)
        - 日期格式      YYYY-MM-DD

    TimeField(DateTimeCheckMixin, Field)
        - 时间格式      HH:MM[:ss[.uuuuuu]]

    DurationField(Field)
        - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型

    FloatField(Field)
        - 浮点型

    DecimalField(Field)
        - 10进制小数
        - 参数：
            max_digits，小数总长度
            decimal_places，小数位长度

    BinaryField(Field)
        - 二进制类型

字段

　　注：

　　EmailField等用于django admin 验证使用。
　　如图
　　

四：字段参数

　　　　 null 数据库中字段是否可以为空    db_column 数据库中字段的列名    db_tablespace

    default             数据库中字段的默认值
    primary_key         数据库中字段是否为主键
    db_index            数据库中字段是否可以建立索引
    unique              数据库中字段是否可以建立唯一索引
    unique_for_date     数据库中字段【日期】部分是否可以建立唯一索引
    unique_for_month    数据库中字段【月】部分是否可以建立唯一索引
    unique_for_year     数据库中字段【年】部分是否可以建立唯一索引

    verbose_name        Admin中显示的字段名称
    blank               Admin中是否允许用户输入为空
    editable            Admin中是否可以编辑
    help_text           Admin中该字段的提示信息
    choices             Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作
                        如：gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1)

    error_messages      自定义错误信息（字典类型），从而定制想要显示的错误信息；
                        字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
                        如：{'null': "不能为空.", 'invalid': '格式错误'}

    validators          自定义错误验证（列表类型），从而定制想要的验证规则
                        from django.core.validators import RegexValidator
                        from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
                        MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
                        如：
                            test = models.CharField(
                                max_length=32,
                                error_messages={
                                    'c1': '优先错信息1',
                                    'c2': '优先错信息2',
                                    'c3': '优先错信息3',
                                },
                                validators=[
                                    RegexValidator(regex='root_\d+', message='错误了', code='c1'),
                                    RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'),
                                    EmailValidator(message='又错误了', code='c3'), ]
                            )

    unique_for_date #只对时间做索引
    unique_for_month     #只对月分做索引
    unique_for_year
　　 auto_now  #更新时，自动更新为当前时间
    auto_now_add #创建时，自动生成

　　注意：auto_now,auto_now_add,choince使用

 　　　　obj=UserGroup.objects.filter(id=1).update(caption="CEO")#这种方式utime不会更新

    　　#下面方式更新 utime
    　　obj=UserGroup.objects.filter(id=1).filter()
    　　obj.caption="CEO"
    　　obj.save()

    auto_now  #更新时，自动更新为当前时间
    auto_now_add #创建时，自动生成

    class UserGroup(models.Model):
        uid=models.AutoField(primary_key=True)
        caption=models.CharField(max_length=32)
        ctime=models.DateTimeField(auto_now_add=True,null=True)
        utime=models.DateTimeField(auto_now=True,null=True)

    obj=UserGroup.objects.filter(id=1).update(caption="CEO")#这种方式utime不会更新
    #下面方式更新 utime
    obj=UserGroup.objects.filter(id=1).filter()
    obj.caption="CEO"
    obj.save()

    choices,给django admin显示下拉框，避免连表查询
         user_type_choices=(
            (1,"超级用户"),
             (2,"普通用户"),
            (3,"铺能用户"),

        )#这里是放在内存里面
        user_type_id=models.IntegerField(choices=user_type_choices,default=1) #给django admin显示下拉框，避免连表查询