Django模型

一、基础

• 每个模型都是一个 Python 的类，这些类继承自 django.db.models.Model。
• 模型类的每个属性都相当于一个数据库的字段。

模型基本结构：

class 模型名（机器读）(models.Model):
    字段名（机器读） = models.字段类型Field(参数设置)

    def __str__(self):
        return self.字段名

    class Meta:
        db_table = "表名（机器读）"
        verbose_name = '可读模型名（人可读）'
        verbose_name_plural = '复数形式可读模型名（人可读）'

二、使用模型

1.应用路由配置

工程目录下urls.py

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('应用名/', include('应用名.urls')),
]

2.应用配置

settings.py

INSTALLED_APPS = [
    # 自定义
    '应用名.apps.应用名（首字母大写）Config',

    # Django自带
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    # 第三方
    'widget_tweaks',
]

3.数据库配置

settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '数据库名',
        'USER': 'root',
        'PASSWORD': '',
        'HOST': '127.0.0.1',
        'PORT': '3306',
    }
}

4.数据库迁移

完成应用的模型代码编写后，可运行以下命令激活模型：

...\> python manage.py makemigrations
...\> python manage.py migrate

三、字段

文档：https://docs.djangoproject.com/zh-hans/2.2/ref/models/fields/

1.字段类型

（1）自增列

字段类型	描述
AutoField	自增列
BigAutoField	大自增列，1 ~ 9223372036854775807

注意：自增列必须填入参数 primary_key=True。
如果model中没有自增列，则自动会创建一个列名为id的自增列。

（2）数值型

字段类型	描述
BinaryField	二进制型列
SmallIntegerField	小整数列，-32768 ～ 32767
PositiveSmallIntegerField	正小整数列，0 ～ 32767
IntegerField	整数列(有符号的)，-2147483648 ～ 2147483647
PositiveIntegerField	正整数列，0 ～ 2147483647
BigIntegerField	长整数列(有符号的) ，-9223372036854775808 ～ 9223372036854775807
BooleanField	布尔型列，不允许为空
NullBooleanField	布尔型列，允许为空
FloatField	浮点型列
DecimalField	十进制小数列（max_digits：总长度，decimal_places：小数位数）

（3）字符串型

字段类型	描述
CharField	可变长字符型列（varchar），必须提供max_length参数， max_length表示字符长度
TextField	长文本型列（longtext）

（4）日期型

字段类型	描述
DateField	日期型列，YYYY-MM-DD
TimeField	时间型列，HH:MM[:ss[.uuuuuu]]
DateTimeField	日期时间型列，YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]
DurationField	时间间隔型列

（5）其他类型

字段类型	描述
EmailField	邮箱列，Django Admin以及ModelForm中提供验证机制
IPAddressField	IPV4地址列，Django Admin以及ModelForm中提供验证IPV4 机制
GenericIPAddressField	IP地址列，Django Admin以及ModelForm中提供Ipv4和Ipv6验证机制

（6）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)',

2.字段选项

字段参数	描述
null	数据库中字段是否可以为空（null=True）
db_column	数据库中字段的列名(db_column="test")
db_tablespace	指定这个模型对应的数据库表放在哪个数据库表空间
default	数据库中字段的默认值
primary_key	数据库中字段是否为主键(primary_key=True)
db_index	数据库中字段是否可以建立索引(db_index=True)
unique	数据库中字段是否可以建立唯一索引(unique=True)
unique_for_date	数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month	数据库中字段【月】部分是否可以建立唯一索引
unique_for_year	数据库中字段【年】部分是否可以建立唯一索引
auto_now	更新时自动更新当前时间
auto_now_add	创建时自动更新当前时间
verbose_name	Admin中显示的字段名称
blank	Admin中是否允许用户输入为空 表单提交时可以为空
editable	Admin中是否可以编辑
help_text	Admin中该字段的提示信息
choices	Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作

四、Meta选项

元数据	描述
app_label	指定该模型属于哪一个应用
db_table	表名（机器读）
db_tablespace	定义数据库表空间的名字
get_latest_by	指定lastest()方法的参照字段
managed	指定是否根据模型类生成映射的数据库表（默认为True）
order_with_respect_to	按照给定的字段把这个对象标记为”可排序的“
ordering	指定排序的参照字段
permissions	设置创建对象时权限表中额外的权限
unique_together	设置的不重复的字段组合
index_together	设置带有索引的字段组合
abstract	指定该模型是否作为基类用于被继承
proxy	指定该模型子类的另一个模型是否会被视为代理模型
verbose_name	可读模型名（人可读）
verbose_name_plural	复数形式可读模型名（人可读）