Django model 字段类型及选项解析---转载
model field 类型
1、AutoField()
自增的IntegerField,通常不用自己设置,若没有设置主键,Django会自动添加它为主键字段,Django会自动给每张表添加一个自增的primary key。
2、BigIntegerField
64位整数, -9223372036854775808 到 9223372036854775807。默认的显示widget 是 TextInput.
3、BinaryField ( Django 1.6 版本新增 )
存储二进制数据。不能使用 filter 函数获得 QuerySet
4、BooleanField()
True/False,默认的widget 是 CheckboxInput。
如果需要置空,则必须用 NullBooleanField 代替。
Django 1.6 修改:BooleanField 的默认值 由 False 改为 None,在 default 属性未设置的情况下。
5、CharField(max_length=none[, **options])
储存字符串。必须有 max_length 参数指定长度。作用于数据层级和django数据验证层级。默认的form widget 是 TextInput如果字符串巨长,推荐使用 TextField。
6、CommaSeparatedIntegerField(max_length=none[, **options])
存放由逗号间隔的整数序列。必须有 max_length 参数。
7、DateField
日期,与python里的datetime.date 实例同。有以下几个可选的选项,均为bool类型:
DateField.auto_now: 每次执行 save 操作的时候自动记录当前时间,常作为最近一次修改的时间 使用。注意:总是在执行save 操作的时候执行,无法覆盖。
DateField.auto_now_add: 第一次创建的时候添加当前时间。常作为 创建时间 使用。注意:每次create 都会调用。
默认的form widget 是 TextInput。
注意:设置auto_now 或者 auto_now_add 为 True 会导致当前自动拥有 editable=False 和 blank = True 设置。
8、DateTimeField([auto_now=False, auto_now_add=False, **options])
日期+时间。与python里的 datetime.datetime 实例同。常用附加选项和DateField一样。
默认 form widget 是一个 TextInput
9、DecimalField(max_digits=None,decimal_places=None[, **options])
用decimal实例表示固定精度的十进制数的字段,有两个必须参数,max_digits数字允许的最大位数,decimal_places小数的最大位数。django后台用表示该字段, 通常用来表示金额
10、EmailField([maxlength=75, **options])
在 CharField 基础上附加了 邮件地址合法性验证。不需要强制设定 max_length
注意:当前默认设置 max_length 是 75,虽然已经不符合标准,但未了向前兼容,未修改。
11、FileField(upload_to=None[, max_length=100, **options])
文件上传字段。不支持 primary_key 和 unique 选项。否则会报 TypeError 异常。
必须设置 FileField.upload_to 选项,这个是 本地文件系统路径,附加在 MEDIA_ROOT 设置的后边,也就是 MEDIA_ROOT 下的子目录相对路径。默认的form widget 是 FileInput。
12、FloatField
与 python 里的 float 实例相同,默认的 form widget 是 TextInput。
虽然 FloatField 与 DecimalField 都是表示实数,但却是不同的表现形式,FloatField 用的是 python d float 类型,但是 DecimalField 用的却是 Decimal 类型。区别可见:http://docs.python.org/2.7/library/decimal.html#decimal
13、ImageField([upload_to=None, height_field=None, width_field=None, max_length=100, **options])
在 FileField 基础上加上是否是合法图片验证功能的一个类型。
除了 FileField 有的属性外,ImageField 另有 height 和 width 属性。
注意:需要安装 PIL 或者 Pillow 模块。在数据库中同样表现为 varchar(100),可通过 max_length 改大小。
14、IntegerField
整数,默认的form widget 是 TextInput。
15、IPAddressField
IP地址,字符串类型,如 127.0.0.1。默认 form widget 是 TextInput。
16、GenericIPAddressField
ip v4和ip v6地址表示,ipv6遵循RFC 4291section 2.2,
17、NullBooleanField
可以包含空值的布尔类型,相当于设置了null=True的BooleanField。
18、PositiveSmallIntegerField
正短整数或0类型,类似于PositiveIntegerField,取值范围依赖于数据库特性,[0 ,32767]的取值范围对Django所支持的数据库都是安全的。
19、PositiveIntegerField
正整数或0类型,取值范围为[0 ,2147483647]
20、SlugField
只能包含字母,数字,下划线和连字符的字符串,通常被用于URLs表示。可选参数max_length=50,prepopulate_from用于指示在admin表单中的可选值。db_index,默认为True。
21.SmallIntegerField
小整数字段,类似于IntegerField,取值范围依赖于数据库特性,[-32768 ,32767]的取值范围对Django所支持的数据库都是安全的。
22、TextField
大文本,巨长的文本。默认的 form widget 是 Textarea。
23、TimeField
时间,对应Python的datetime.time
24、URLField
加了 URL 合法性验证的 CharField。
默认的 form widget 是 TextInput。
默认max_length=200,可修改。
25、FilePathField(path=None[, match=None, recursive=False, max_length=100, options])
他是一个CharField,用来选择文件系统下某个目录里面的某些文件,它有三个专有参数,只有path是必须的。path是一个目录的绝对路径,match是一个正则表达式字符串,用来过滤文件名称;recursive为bool,指定是否包含path下的子目录。
注意,如果使用 MySQLdb 1.2.1p2 和 utf-8_bin 编码,会有一些问题https://docs.djangoproject.com/en/dev/ref/databases/#mysql-collation。具体问题未分析,可自行避开。
Field 选项
null
boolean 值,缺省设置为false。通常不将其用于字符型字段上,比如CharField,TextField上。字符型字段如果没有值会返回空字符串。
blank
boolean 值,该字段是否可以为空。如果为假,则必须有值。
choices
元组值,一个用来选择值的2维元组。第一个值是实际存储的值,第二个用来方便进行选择。如SEX_CHOICES=((‘F’,’Female’),(‘M’,’Male’),)
db_column
string 值,指定当前列在数据库中的名字,不设置,将自动采用model字段名;
db_index
boolean 值,如果为True将为此字段创建索引;
default
给当前字段设定的缺省值,可以是一个具体值,也可以是一个可调用的对象,如果是可调用的对象将每次产生一个新的对象;
editable
boolean 值,如果为假,admin模式下将不能改写。缺省为真;
error_messages
字典,设置默认的出错信息,可覆盖的key 有 null, blank, invalid, invalid_choice, 和 unique。
help_text
admin模式下帮助文档
form widget 内显示帮助文本。
primary_key
设置主键,如果没有设置django创建表时会自动加上:id = meta.AutoField(‘ID’, primary_key=True)
primary_key=True implies blank=False, null=False and unique=True. Only one primary key is allowed on an object.
radio_admin
用于 admin 模式下将 select 转换为 radio 显示。只用于 ForeignKey 或者设置了choices
unique
boolean值,数据是否进行唯一性验证;
unique_for_date
字符串类型,值指向一个DateTimeField 或者 一个 DateField的列名称。日期唯一,如下例中系统将不允许title和pub_date两个都相同的数据重复出现
title = meta.CharField( maxlength=30, unique_for_date=’pub_date’ )
unique_for_month / unique_for_year
用法同上
verbose_name
string类型。更人性化的列名。
validators
有效性检查。无效则抛出 django.core.validators.ValidationError 异常。
Django 模型(Model)字段类型级参数详解
1、AutoField
根据可用id自动递增的整数字段。通常不需要直接使用它;如果不指定主键字段,则会自动将主键字段添加到模型中。
2、CharField
用来存储字符串,必须制定范围,如果存储大文本字符串,应当用TextField.
3、DateField
使用Python的datetime.date实例保存的日期。auto_now = True:每次保存对象时,自动设置该字段为当前时间;auto_now_add=True:对象第一次被创建时自动设置当前时间。需要注意的是,自动保存的时间的时区使用的是默认时区。
4、DateTimeField
使用Python的datetime.datetime实例表示的日期和时间。
5、TextField
存储大字符串
6、BigIntegerField
64位的整型数值,从 -2^63 (-9223372036854775808) 到 2^63-1(9223372036854775807)
7、BinaryField
存储二进制码的Field. 只支持bytes 赋值。
8、BooleanField
该字段的默认表单控件是CheckboxInput,如果你需要设置null 值,则使用NullBooleanField 来代替BooleanField。
9、FloatField
用Python的一个float 实例来表示一个浮点数。
10、UUIDField
一个用来存储UUID的字段。使用Python的UUID类。
11、ForeignKey
多对一关系
12、ManyToManyField
多对多关联
13、OneToOneField
一对一关联关系
1、null=True 数据库中字段是否可以为空
2、blank=True django的 Admin 中添加数据时是否可允许空值
3、primary_key = False
主键,对AutoField设置主键后,就会代替原来的自增 id 列
如果您没有为模型中的任何字段指定primary_key=True, Django将自动添加一个IntegerField来保存主键,所以您不需要在任何字段上设置primary_key=True,除非您想要覆盖默认的主键行为。有关更多信息,请参见自动主键字段。
主键字段是只读的。如果您更改现有对象上的主键值,然后保存它,就会在旧对象旁边创建一个新对象。例如:
from django.db import models
class Fruit(models.Model):
name = models.CharField(max_length=100, primary_key=True)
fruit = Fruit.objects.create(name='Apple')
>>> fruit.name = 'Pear'
>>> fruit.save()
>>> Fruit.objects.values_list('name', flat=True)
<QuerySet ['Apple', 'Pear']>
4、auto_now 和 auto_now_add
auto_now 自动创建---无论添加或修改,都是当前操作的时间
auto_now_add 自动创建---永远是创建时的时间
5、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、name|db_column 数据库中的字段名称
10、unique=True
不允许重复,例如用户名注册时候是不允许重复的,在username字段里设置,不让重复
11、db_index = True 数据库索引
12、editable=True 在Admin里是否可编辑
13、error_messages=None
错误提示
把错误提示修改成你想要的报错,这里加个字典来完成 gender = models.CharField(max_length=2,choices = GENDER_CHOICE,error_messages={"错误类型":"错误原因"})
14、auto_created=False 自动创建
15、help_text 在Admin中提示帮助信息
16、validators=[] 提示区间,例如电话号码范围
17、upload-to 文件上传功能 在 FileField 里加入 例如: file = modles.FileField(upload-to = "./upload/" 指明上传的文件防止根目录下的/upload/文件夹下
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])
- FilePathField.path:文件的绝对路径,必填
- FilePathField.match:用于过滤路径下文件名的正则表达式,该表达式将用在文件名上(不包括路径)。
- FilePathField.recursive:True 或 False,默认为 False,指定是否应包括所有子目录的路径。
- 例如:FilePathField(path="/home/images", match="foo.*", recursive=True)
将匹配“/home/images/foo.gif”但不匹配“/home/images/foo/bar.gif”
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
- 文件上传时的保存上传文件的目录
models.py
# -*- coding: utf-8 -*-from __future__ import unicode_literalsfrom django.db import modelsclass UserInfo(models.Model):userName = models.CharField(max_length=30) #用户名passWord = models.CharField(max_length=30) #密码gendle = models.BooleanField() #性别birthday = models.DateField() #出生日期weigth = models.FloatField() #体重heigth = models.IntegerField() #身高email = models.EmailField() #邮箱host = models.GenericIPAddressField() #IP地址introduce = models.TextField() #个人简介blog = models.URLField() #博客地址photo = models.ImageField() #照片CV = models.FilePathField() #个人简历文件createDate = models.DateTimeField() #帐号申请时间
最新文章
- DICOM图像像素值(灰度值)转换为CT值
- pip install lxml出错解决
- Unity-Animator在Editor状态下的单个/批量预览工具
- juqery easyui
- C语言 文件操作10--配置文件读写
- ssh连接慢的问题的解决?
- 织梦dedecms分类信息模型上一页下一页失效办法
- C#实现对文件目录的实时监控
- 调用相册怎么设置剪裁-b
- javascript获得浏览器工作区域的大小
- css系列教程--overflow min/maxheight content
- CSS揭秘(四)视觉效果
- Oracle知识梳理(一)理论篇:基本概念和术语整理
- Python列表之班荆道故
- C#实现按键计算器功能2(增强版)
- PAT 1014 福尔摩斯的约会
- Hive记录-使用Hue管理Hive元数据
- 关于Newtonsoft.Json,反序列化jason,内容有key的转换
- RabbitMQ进阶使用-延时队列的配置(Spring Boot)
- 复合梯形公式、复合辛普森公式 matlab
热门文章
- Python编程中出现ImportError: bad magic number in &#39;numpy&#39;: b&#39;\x03\xf3\r\n&#39;
- jmeter实例介绍
- __x__(31)0908第五天__导航条的练习 <;ul>; 版本
- (62)Wangdao.com第十天_JavaScript 变量的作用域
- jq三级联动
- 循环结构while
- centos开启防火墙
- Java+Selenium操作日期时间选择框插件
- 使用maxwell实时同步mysql数据到kafka
- sqlhelp3