1. django 模型models 常用字段
1、models.AutoField
- 自增列 = int(11)
- 如果没有的话,默认会生成一个名称为 id 的列
- 如果要显式的自定义一个自增列,必须设置primary_key=True。
2、models.CharField
- 字符串字段
- 必须设置max_length参数
3、models.BooleanField
- 布尔类型=tinyint(1)
- 不能为空,可添加Blank=True
4、models.ComaSeparatedIntegerField
- 用逗号分割的数字=varchar
- 继承CharField,所以必须 max_lenght 参数
5、models.DateField
- 日期类型 date
- DateField.auto_now:保存时自动设置该字段为现在日期,最后修改日期
- DateField.auto_now_add:当该对象第一次被创建是自动设置该字段为现在日期,创建日期。
6、models.DateTimeField
- 日期时间类型 datetime
- 同DateField的参数
7、models.Decimal
- 十进制小数类型 = decimal
- DecimalField.max_digits:数字中允许的最大位数
- DecimalField.decimal_places:存储的十进制位数
8、models.EmailField
- 一个带有检查 Email 合法性的 CharField
9、models.FloatField
- 浮点类型 = double
10、models.IntegerField
- 整形
11、models.BigIntegerField
- 长整形
- integer_field_ranges = {
'SmallIntegerField': (-32768, 32767),'IntegerField': (-2147483648, 2147483647),'BigIntegerField': (-9223372036854775808, 9223372036854775807),'PositiveSmallIntegerField': (0, 32767),'PositiveIntegerField': (0, 2147483647),}
12、models.GenericIPAddressField
- 一个带有检查 IP地址合法性的 CharField
13、models.NullBooleanField
- 允许为空的布尔类型
14、models.PositiveIntegerFiel
- 正整数
15、models.PositiveSmallIntegerField
- 正smallInteger
16、models.SlugField
- 减号、下划线、字母、数字
17、models.SmallIntegerField
- 数字
- 数据库中的字段有:tinyint、smallint、int、bigint
18、models.TextField
- 大文本。默认对应的form标签是textarea。
19、models.TimeField
- 时间 HH:MM[:ss[.uuuuuu]]
20、models.URLField
- 一个带有URL合法性校验的CharField。
21、models.BinaryField
- 二进制
- 存储二进制数据。不能使用filter函数获得QuerySet。
22、models.ImageField
- 图片
- ImageField.height_field、ImageField.width_field:如果提供这两个参数,则图片将按提供的高度和宽度规格保存。
- 该字段要求 Python Imaging 库Pillow。
- 会检查上传的对象是否是一个合法图片。
23、models.FileField(upload_to=None[, max_length=100, ** options])
- 文件
- FileField.upload_to:一个用于保存上传文件的本地文件系统路径,该路径由 MEDIA_ROOT 中设置
- 这个字段不能设置primary_key和unique选项.在数据库中存储类型是varchar,默认最大长度为100
24、models.FilePathField(path=None[, math=None, recursive=False, max_length=100, **options])将匹配“/home/images/foo.gif”但不匹配“/home/images/foo/bar.gif”
- FilePathField.path:文件的绝对路径,必填
- FilePathField.match:用于过滤路径下文件名的正则表达式,该表达式将用在文件名上(不包括路径)。
- FilePathField.recursive:True 或 False,默认为 False,指定是否应包括所有子目录的路径。
- 例如:FilePathField(path="/home/images", match="foo.*", recursive=True)
1、null
- 如果是True,Django会在数据库中将此字段的值置为NULL,默认值是False
2、blank
- 如果为True时django的 Admin 中添加数据时可允许空值,可以不填。如果为False则必须填。默认是False。
- null纯粹是与数据库有关系的。而blank是与页面必填项验证有关的
3、primary_key = False
- 主键,对AutoField设置主键后,就会代替原来的自增 id 列
4、auto_now 和 auto_now_add
- auto_now 自动创建---无论添加或修改,都是当前操作的时间
- auto_now_add 自动创建---永远是创建时的时间
5、choices
- 一个二维的元组被用作choices,如果这样定义,Django会select box代替普通的文本框,
- 并且限定choices的值是元组中的值
- GENDER_CHOICE = (
- (u'M', u'Male'),
- (u'F', u'Female'),
- )
- gender = models.CharField(max_length=2,choices = GENDER_CHOICE)
6、max_length
- 字段长度
7、default
- 默认值
8、verbose_name
- Admin中字段的显示名称,如果不设置该参数时,则与属性名。
9、db_column
- 数据库中的字段名称
10、unique=True
- 不允许重复
11、db_index = True
- 数据库索引
12、editable=True
- 在Admin里是否可编辑
13、error_messages=None
- 错误提示
14、auto_created=False
- 自动创建
15、help_text
- 在Admin中提示帮助信息
16、validators=[]
- 验证器
17、upload-to
- 文件上传时的保存上传文件的目录
02-class Meta:
Django模型类的Meta是一个内部类,它用于定义一些Django模型类的行为特性。而可用的选项大致包含以下几类
abstract
这个属性是定义当前的模型是不是一个抽象类。所谓抽象类是不会对应数据库表的。一般我们用它来归纳一些公共属性字段,然后继承它的子类可以继承这些字段。
Options.abstract
如果abstract = True 这个model就是一个抽象类
app_label
这个选型只在一种情况下使用,就是你的模型不在默认的应用程序包下的models.py文件中,这时候需要指定你这个模型是哪个应用程序的。
Options.app_label
如果一个model定义在默认的models.py,例如如果你的app的models在myapp.models子模块下,你必须定义app_label让Django知道它属于哪一个app
app_label = 'myapp'
db_table
db_table是指定自定义数据库表明的。Django有一套默认的按照一定规则生成数据模型对应的数据库表明。
Options.db_table
定义该model在数据库中的表名称
db_table = 'Students'
如果你想使用自定义的表名,可以通过以下该属性
table_name = 'my_owner_table'
db_teblespace
Options.db_teblespace
定义这个model所使用的数据库表空间。如果在项目的settin中定义那么它会使用这个值
get_latest_by
Options.get_latest_by
在model中指定一个DateField或者DateTimeField。这个设置让你在使用model的Manager上的lastest方法时,默认使用指定字段来排序
managed
Options.managed
默认值为True,这意味着Django可以使用syncdb和reset命令来创建或移除对应的数据库。默认值为True,如果你不希望这么做,可以把manage的值设置为False
order_with_respect_to
这个选项一般用于多对多的关系中,它指向一个关联对象,就是说关联对象找到这个对象后它是经过排序的。指定这个属性后你会得到一个get_xxx_order()和set_xxx_order()的方法,通过它们你可以设置或者回去排序的对象
ordering
这个字段是告诉Django模型对象返回的记录结果集是按照哪个字段排序的。这是一个字符串的元组或列表,没有一个字符串都是一个字段和用一个可选的表明降序的'-'构成。当字段名前面没有'-'时,将默认使用升序排列。使用'?'将会随机排列
- ordering=['order_date'] # 按订单升序排列
- ordering=['-order_date'] # 按订单降序排列,-表示降序
- ordering=['?order_date'] # 随机排序,?表示随机
- ordering=['-pub_date','author'] # 以pub_date为降序,在以author升序排列
permissions
permissions主要是为了在Django Admin管理模块下使用的,如果你设置了这个属性可以让指定的方法权限描述更清晰可读。Django自动为每个设置了admin的对象创建添加,删除和修改的权限。
permissions = (('can_deliver_pizzas','Can deliver pizzas'))
proxy
这是为了实现代理模型使用的,如果proxy = True,表示model是其父的代理 model
unique_together
unique_together这个选项用于:当你需要通过两个字段保持唯一性时使用。比如假设你希望,一个Person的FirstName和LastName两者的组合必须是唯一的,那么需要这样设置:
unique_together = (("first_name", "last_name"),)
一个ManyToManyField不能包含在unique_together中。如果你需要验证关联到ManyToManyField字段的唯一验证,尝试使用signal(信号)或者明确指定through属性。
verbose_name
verbose_name的意思很简单,就是给你的模型类起一个更可读的名字一般定义为中文,我们:
verbose_name = "学校"
verbose_name_plural
这个选项是指定,模型的复数形式是什么,比如:
verbose_name_plural = "学校"
如果不指定Django会自动在模型名称后加一个’s’
class Meta: db_table = "tb_users" # 指明数据库表名 verbose_name = "用户" # 在admin站点中显示的名称 verbose_name_plural = verbose_name # 显示的复数名称