Django框架(五):模型(一) 定义属性

1. 定义属性

Django根据属性的类型确定以下信息:

  • 当前选择的数据库支持字段的类型
  • 渲染管理表单时使用的默认html控件
  • 在管理站点最低限度的验证

django会为表创建自动增长的主键列,每个模型只能有一个主键列,如果使用选项设置某属性为主键列后django不会再创建自动增长的主键列。

默认创建的主键列属性为id,可以使用pk代替,pk全拼为primary key。

pk是主键的别名,若主键名为id2,那么pk是id2的别名。

属性命名限制:

  • 不能是python的保留关键字。
  • 不允许使用连续的下划线,这是由django的查询方式决定的,在第4节会详细讲解查询。
  • 定义属性时需要指定字段类型,通过字段类型的参数指定选项。

前面已经简单的使用过了,只是没有详细介绍,语法:

属性=models.字段类型(选项)

1.1 字段类型

(1) AutoField

自动增长的IntegerField,通常不用指定,不指定时Django会自动创建属性名为id的自动增长属性。

自定义一个主键:

my_id=models.AutoField(primary_key=True)

(2) BooleanField

布尔字段,值为True或False。

(3) NullBooleanField

类似BooleanField,支持Null、True、False三种值。

(4) CharField(max_length=字符长度)

字符串。

参数max_length表示最大字符个数。

(5) TextField

大文本字段,一般超过4000个字符时使用。

(6) IntegerField

整数。

(7) DecimalField(max_digits=None, decimal_places=None)

十进制浮点数。

参数max_digits表示总位数。

参数decimal_places表示小数位数。

(8) FloatField

浮点数。

(9) DateField[auto_now=False, auto_now_add=False])

日期。

参数auto_now表示每次保存对象时,自动设置该字段为当前时间,用于"最后一次修改"的时间戳,它总是使用当前日期,默认为false。

参数auto_now_add表示当对象第一次被创建时自动设置当前时间,用于创建的时间戳,它总是使用当前日期,默认为false。

参数auto_now_add和auto_now是相互排斥的,组合将会发生错误。

(10) TimeField

时间,参数同DateField。

(11) DateTimeField

日期时间,参数同DateField。

(12) FileField

上传文件字段。

参数:upload_to,一个用于保存上传文件的本地文件系统路径。

(13) ImageField

继承于FileField,对上传的内容进行校验,确保是有效的图片。

有两个可选参数:height_field和width_field。将图片按照提供的高度和宽度规格保存。

(14) CommaSeparatedIntegerField(max_length)

逗号分隔开的整数字段。

参数与CharField一样。

(15) FilePathField(path,[match],[recursive])

拥有多个可选项的字段,选项被限定为文件系统中某个目录下的文件名。

(16) EmailField

能检查值是否是有效的电子邮件地址的CharField。

(17) IPAddressField

IP地址,以字符串格式表示。

例如:"192.168.0.1"

(18) PhoneNumberField

检查值是否是一个合法的美式电话格式。

(19) PositiveIntegerField

和IntegerField类似,但是必须是正值。

(20) SlugField

内容简短的标签,这段内容只能包含字母、数字、下划线或连字符。通常用于URL中。

(21) SmallIntegerField

和IntegerField类似,但是只允许在一个数据库相关的范围内的数值(通常是-32,768到+32,767)

(22) URLField

用来存储URL的字段。

(23) USStateField

美国州名字缩写,两个字母。

(24) XMLField(schema_path)

类似TextField,只不过要检查值是否匹配指定schema的合法XML。

1.2 选项

通过选项实现对字段的约束。

null:如果为True,表示允许为空,默认值是False。

blank:如果为True,则该字段允许为空白,默认值是False。

要注意,这与 null 不同。null纯粹是数据库范畴的,而blank是数据验证范畴的。

如果一个字段的blank=True,表单的验证将允许该字段是空值。如果字段的blank=False,该字段就是必填的。

db_column:字段的名称,如果未指定,则使用属性的名称。

db_index:若值为True, 则在表中会为此字段创建索引,默认值是False。

default:默认值。

primary_key:若为True,则该字段会成为模型的主键字段,默认值是False,一般作为AutoField的选项使用。

unique:如果为True, 这个字段在表中必须有唯一值,默认值是False。

choices:一个包含双元素元组的可迭代的对象,用于给字段提供选项。

editable:如果为False,这个字段在管理界面或表单里将不能编辑。默认为True。

help_text:在管理界面表单对象里显示在字段下面的额外帮助文本。

radio_admin:默认的,对于ForeignKey或者拥有choices设置的字段,Django管理界面会使用列表选择框(