name = models.CharField(max_length=20, verbose_name='名称')
# blank: 如果为True,则该字段允许为空白,默认值是False admin站点运营时可以为空白, 写入数据的是一个空的字符串
# on_delete: 在设置外键时,需要通过on_delete选项指明主表删除数据时,对于外键引用表数据如何处理
# SET_NULL 在父表上update/delete记录时,将子表上匹配记录的列设为null
# related_name: 该外键定义好名称, 方便主表调用
# null: 允许字段为空
parent = models.ForeignKey('self', on_delete=models.SET_NULL, related_name='subs', null=True, blank=True, verbose_name='上级行政区划')
类型说明
AutoField: 自动增长的IntegerField,通常不用指定,不指定时Django会自动创建属性名为id的自动增长属性
BooleanField: 布尔字段,值为True或False
NullBooleanField: 支持Null、True、False三种值
CharField: 字符串,参数max_length表示最大字符个数
TextField: 大文本字段,一般超过4000个字符时使用
IntegerField: 整数
DecimalField: 十进制浮点数, 参数max_digits表示总位数, 参数decimal_places表示小数位数
FloatField: 浮点数
DateField: 日期, 参数auto_now表示每次保存对象时,自动设置该字段为当前时间,用于"最后一次修改"的时间戳,它总是使用当前日期,默认为False; 参数auto_now_add表示当对象第一次被创建时自动设置当前时间,用于创建的时间戳,它总是使用当前日期,默认为False; 参数auto_now_add和auto_now是相互排斥的,组合将会发生错误
TimeField: 时间,参数同DateField
DateTimeField: 日期时间,参数同DateField
FileField: 上传文件字段
ImageField: 继承于FileField,对上传的内容进行校验,确保是有效的图片
选项
选项说明
null: 如果为True,表示允许为空,默认值是False
blank: 如果为True,则该字段允许为空白,默认值是False, 空白指在数据库存储的是一个空的字符串 ''
db_column: 字段的名称,如果未指定,则使用属性的名称
db_index: 若值为True, 则在表中会为此字段创建索引,默认值是False
default: 默认
primary_key: 若为True,则该字段会成为模型的主键字段,默认值是False,一般作为AutoField的选项使用
unique: 如果为True, 这个字段在表中必须有唯一值,默认值是False
null是数据库范畴的概念,blank是表单验证范畴的
外键
在设置外键时,需要通过on_delete选项指明主表删除数据时,对于外键引用表数据如何处理,在django.db.models中包含了可选常量:
CASCADE 级联,删除主表数据时连通一起删除外键表中数据
PROTECT 保护,通过抛出ProtectedError异常,来阻止删除主表中被外键应用的数据
SET_NULL 设置为NULL,仅在该字段null=True允许为null时可用
SET_DEFAULT 设置为默认值,仅在该字段设置了默认值时可用
SET() 设置为特定值或者调用特定方法,如
DO_NOTHING 不做任何操作,如果数据库前置指明级联性,此选项会抛出IntegrityError异常