django第三次（转自刘江）

所有的模型字段都可以接收一定数量的参数&＃xff0c;比如CharField至少需要一个max_length参数。下面的这些参数是所有字段都可以使用的&＃xff0c;并且是可选的。

null

该值为True时&＃xff0c;Django在数据库用NULL保存空值。默认值为False。对于保存字符串类型数据的字段&＃xff0c;请尽量避免将此参数设为True&＃xff0c;那样会导致两种‘没有数据’的情况&＃xff0c;一种是NULL&＃xff0c;另一种是‘空字符串’。

blank

True时&＃xff0c;字段可以为空。默认False。和null参数不同的是&＃xff0c;null是纯数据库层面的&＃xff0c;而blank是验证相关的&＃xff0c;它与表单验证是否允许输入框内为空有关&＃xff0c;与数据库无关。所以要小心一个null为False&＃xff0c;blank为True的字段接收到一个空值可能会出bug或异常。

choices

用于页面上的选择框标签&＃xff0c;需要先提供一个二维的二元元组&＃xff0c;第一个元素表示存在数据库内真实的值&＃xff0c;第二个表示页面上显示的具体内容。在浏览器页面上将显示第二个元素的值。例如&＃xff1a;

一般来说&＃xff0c;最好将选项定义在类里&＃xff0c;并取一个直观的名字&＃xff0c;如下所示&＃xff1a;

要获取一个choices的第二元素的值&＃xff0c;可以使用get_FOO_display()方法&＃xff0c;其中的FOO用字段名代替。对于下面的例子&＃xff1a;

使用方法&＃xff1a;

db_column

该参数用于定义当前字段在数据表内的列名。如果未指定&＃xff0c;Django将使用字段名作为列名。

db_index

该参数接收布尔值。如果为True&＃xff0c;数据库将为该字段创建索引。

db_tablespace

用于字段索引的数据库表空间的名字&＃xff0c;前提是当前字段设置了索引。默认值为工程的DEFAULT_INDEX_TABLESPACE设置。如果使用的数据库不支持表空间&＃xff0c;该参数会被忽略。

default

字段的默认值&＃xff0c;可以是值或者一个可调用对象。如果是可调用对象&＃xff0c;那么每次创建新对象时都会调用。设置的默认值不能是一个可变对象&＃xff0c;比如列表、集合等等。lambda匿名函数也不可用于default的调用对象&＃xff0c;因为匿名函数不能被migrations序列化。

注意&＃xff1a;在某种原因不明的情况下将default设置为None&＃xff0c;可能会引发intergyerror&＃xff1a;not null constraint failed&＃xff0c;即非空约束失败异常&＃xff0c;导致python manage.py migrate失败&＃xff0c;此时可将None改为False或其它的值&＃xff0c;只要不是None就行。

editable

如果设为False&＃xff0c;那么当前字段将不会在admin后台或者其它的ModelForm表单中显示&＃xff0c;同时还会被模型验证功能跳过。参数默认值为True。

error_messages

用于自定义错误信息。参数接收字典类型的值。字典的键可以是null、 blank、 invalid、 invalid_choice、 unique和unique_for_date其中的一个。

help_text

额外显示在表单部件上的帮助文本。使用时请注意转义为纯文本&＃xff0c;防止脚本攻击。

primary_key

如果你没有给模型的任何字段设置这个参数为True&＃xff0c;Django将自动创建一个AutoField自增字段&＃xff0c;名为‘id’&＃xff0c;并设置为主键。也就是id &＃61; models.AutoField(primary_key&＃61;True)。

如果你为某个字段设置了primary_key&＃61;True&＃xff0c;则当前字段变为主键&＃xff0c;并关闭Django自动生成id主键的功能。

primary_key&＃61;True隐含null&＃61;False和unique&＃61;True的意思。一个模型中只能有一个主键字段&＃xff01;

另外&＃xff0c;主键字段不可修改&＃xff0c;如果你给某个对象的主键赋个新值实际上是创建一个新对象&＃xff0c;并不会修改原来的对象。

unique

设为True时&＃xff0c;在整个数据表内该字段的数据不可重复。

注意&＃xff1a;对于ManyToManyField和OneToOneField关系类型&＃xff0c;该参数无效。

注意&＃xff1a; 当unique&＃61;True时&＃xff0c;db_index参数无须设置&＃xff0c;因为unqiue隐含了索引。

注意&＃xff1a;自1.11版本后&＃xff0c;unique参数可以用于FileField字段。

unique_for_date

日期唯一。可能不太好理解。举个栗子&＃xff0c;如果你有一个名叫title的字段&＃xff0c;并设置了参数unique_for_date&＃61;"pub_date"&＃xff0c;那么Django将不允许有两个模型对象具备同样的title和pub_date。有点类似联合约束。

unique_for_month

同上&＃xff0c;只是月份唯一。

unique_for_year

同上&＃xff0c;只是年份唯一。

verbose_name

为字段设置一个人类可读&＃xff0c;更加直观的别名。

对于每一个字段类型&＃xff0c;除了ForeignKey、ManyToManyField和OneToOneField这三个特殊的关系类型&＃xff0c;其第一可选位置参数都是verbose_name。如果没指定这个参数&＃xff0c;Django会利用字段的属性名自动创建它&＃xff0c;并将下划线转换为空格。

下面这个例子的verbose name是"person’s first name":

下面这个例子的verbose name是"first name":

对于外键、多对多和一对一字字段&＃xff0c;由于第一个参数需要用来指定关联的模型&＃xff0c;因此必须用关键字参数verbose_name来明确指定。如下&＃xff1a;

另外&＃xff0c;你无须大写verbose_name的首字母&＃xff0c;Django自动为你完成这一工作。

validators

运行在该字段上的验证器的列表。