4.model 字段

一、字段名

字段名	类型	参数
AutoField(Field)	- int自增列，	必须填入参数 primary_key=True
BigAutoField(AutoField)	- bigint自增列	必须填入参数 primary_key=True
SmallIntegerField(IntegerField):	SmallIntegerField(IntegerField):
PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)	- 正小整数 0 ～ 32767
IntegerField(Field)	- 整数列(有符号的) -2147483648 ～ 2147483647
PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)	- 正整数 0 ～ 2147483647
BigIntegerField(IntegerField):	- 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
BooleanField(Field)	- 布尔值类型
NullBooleanField(Field):	- 可以为空的布尔值
CharField(Field)	- 字符类型	- 必须提供max_length参数， max_length表示字符长度
TextField(Field)	- 文本类型
EmailField(CharField)：	- 字符串类型，Django Admin以及ModelForm中提供验证机制
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)	- 二进制类型

注：当model中如果没有自增列，则自动会创建一个列名为id的列,自增列必须为主键，因为mysql一张表中只能有一个自增列。英文详解如下：

'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)',

二、字段中常用参数

null 数据库中字段是否可以为空，注意和blank比较

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 EmailValidator

from django.core.validators import RegexValidator

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'), ])

三、Meta信息：

class Meta:

# 数据库中生成的表名称 默认 app名称 + 下划线 + 类名

db_table = "table_name"

# 联合索引

index_together = [("pub_date", "deadline"), ]

# 联合唯一索引

unique_together = (("driver", "restaurant"),)

# admin中显示的表名称

verbose_name = "用名信息"

# verbose_name加s。admin中复数形式

verbose_name_plural = verbose_name

#定义排序规

ordering = "-object_id" #通过object_id做到许排序。

四、model字段格式检查

1、触发Model中的验证和错误提示

（1）Django Admin中的错误信息会优先根据Admin内部的ModelForm错误信息提示，如果都成功，才来检查Model的字段并显示指定错误信息

#model.py文件中

class UserInfo(models.Model):

nid = models.AutoField(primary_key=True)

username = models.CharField(max_length=32)

email = models.EmailField(error_messages={'invalid': '格式错了.'})

这样就会提示格式错误

（2）调用Model对象的 clean_fields 方法

# views.py

def index(request):

obj = models.UserInfo(username='11234', email='uu')

try:

print(obj.clean_fields())

except Exception as e:

print(e)

return HttpResponse('ok')

# Model的clean方法是一个钩子，可用于定制操作，如：上述的异常处理。

（3）Admin中修改错误提示，（也即是用django的form方法）

from django import forms

from django.contrib import admin

from model_club import models

class UserInfoForm(forms.ModelForm):

username = forms.CharField(error_messages={'required': '用户名不能为空.'})

email = forms.EmailField(error_messages={'invalid': '邮箱格式错误.'})

age = forms.IntegerField(initial=1, error_messages={'required': '请输入数值.', 'invalid': '年龄必须为数值.'})

class Meta:

model = models.UserInfo

# fields = ('username',)

fields = "__all__"

class UserInfoAdmin(admin.ModelAdmin):

form = UserInfoForm

admin.site.register(models.UserInfo, UserInfoAdmin)