python-django 模型model字段类型说明

V=models.CharField(max_length=None<, **options>)　　　　#varchar

V=models.EmailField(<max_length=75, **options="">)　　　　#varchar

V=models.URLField(<verify_exists=true, **options="" max_length="200,">)　　　　#varchar

V=models.FileField(upload_to=None<, max_length=100, **options>)　　　　#varchar #upload_to指定保存目录可带格式，

V=models.ImageField(upload_to=None<, height_field=None, width_field=None, max_length=100, **options>)

V=models.IPAddressField(<**options>)　　　　#varchar

V=models.FilePathField(path=None<, match=None, recursive=False, max_length=100, **options>)　#varchar

V=models.SlugField(<max_length=50, **options="">)　　　　#varchar，标签，内含索引

V=models.CommaSeparatedIntegerField(max_length=None<, **options>)　　　　#varchar

V=models.IntegerField(<**options>)　　　　#int

V=models.PositiveIntegerField(<**options>)　　　　#int 正整数

V=models.SmallIntegerField(<**options>)　　　　#smallint

V=models.PositiveSmallIntegerField(<**options>)　　　　#smallint 正整数

V=models.AutoField(**options)　　　　#int；在Django代码内是自增

V=models.DecimalField(max_digits=None, decimal_places=None<, **options>)　　　　#decimal

V=models.FloatField(<**options>)　　　　#real V=models.BooleanField(**options)　　　　#boolean或bit

V=models.NullBooleanField(<**options>)　　　　#bit字段上可以设置上null值

V=models.DateField(<auto_now=false, **options="" auto_now_add="False,">)　　#date #auto_now最后修改记录的日期；auto_now_add添加记录的日期

V=models.DateTimeField(<auto_now=false, **options="" auto_now_add="False,">)　　　　#datetime

V=models.TimeField(<auto_now=false, **options="" auto_now_add="False,">)　　　　#time

V=models.TextField(<**options>)　　　　#text

V=models.XMLField(schema_path=None<, **options>)　　　　#text ——————————————————————————–

V=models.ForeignKey(othermodel<, **options>)　　　　#外键，关联其它模型，创建关联索引

V=models.ManyToManyField(othermodel<, **options>)　　　　#多对多，关联其它模型，创建关联表

V=models.OneToOneField(othermodel<, parent_link=False, **options>)　　　　#一对一，字段关联表属性

django 中model 作为数据资源指定了字段以及一些处理该相应的功能。通常情况下，每个model对应数据库中的一张表 每个model都是从django.core.meta.Model中派生出来的model中每个属性(class attribute)对应着数据库表中的一个字段非字段信息(Model metadata)在类中被称作METAField Objects每个class attributes对应着数据库中的一个字段，其应该是由meta.Filed的派生的。

from django.core import metaclass Person(meta.Model):    first_name = meta.CharField(maxlength=30)    last_name = meta.CharFiled("lastname",maxlength=30) 除了 ForeignKey, ManytoManyFiled OneToOneField 使用verbose_name关键字以外，第一个可选参数是用来为字段命名的，如果不设置，系统会自动为起起名。sites = meta.ManyToManyField(site,verbose_name="list of sites")

Field 选项

null     null 缺省设置为false.通常不将其用于字符型字段上，比如CharField,TextField上.字符型字段如果没有值会返回空字符串。

blank    该字段是否可以为空。如果为假，则必须有值

choices    一个用来选择值的2维元组。第一个值是实际存储的值，第二个用来方便进行选择。    SEX_CHOICES= (('F','Female'),('M','Male'),) coredb_columndb_index    如果为真将为此字段创建索引

default    缺省值

editable    如果为假，admin模式下将不能改写。缺省为真

help_text    admin模式下帮助文档

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    数据唯一

unique_for_date    title =  meta.CharField(maxlength=30,unique_for_date='pub_date')    系统将不允许title和pub_date两个都相同的数据重复出现 unique_for_month / unique_for_year

validator_list    有效性检查。非有效产生 django.core.validators.ValidationError 错误

Field Types

AutoField     自动增长的整型字段。通常无需自己添加

BooleanFieldCharField    对于大量文字应该使用TextField。参数： maxlength

DateField    参数：

auto_now  自动设置为对象保存时刻的时间。对于类似最后改动之类的应用很有效

auto_now_add  从最初保存对象至今的增量时间

DateTimeField 同上EmailField     检查是否为email的CharField字段

FileField    保存文件的相对路径名称    绝对路径需要在setting中设置 MEDIA_ROOT。对于ImageField设置 MEDIA_URL。    参数upload_to.相对于MEDIA_ROOT目录的子目录    通过get_<fieldname>_url获取绝对路径

FilePathField    通过给定参数获取文件列表（个人感觉）    path 必须要有。 文件系统的绝对路径    match 可选。一个正则表达式。用来做文件筛选过滤    recursive 可选。True 包含子目录查找    FilePathField(path="/home/images", match="foo.*" , recursive=True)

FloatField    浮点数字段。两个必须选项    max_digits 数字最多位数    decimal_places 小数点位置    meta.FloatField(...,max_digits=5,decimal_places=2)   /////100.00 ImageField

基本上同FileField.会进行文件格式检查。两个额外选项    height_field, width_field 如果设置这两项，会自动对图片进行缩放后再保存

需要 python Imaging library

IntegerFieldIPAddressField

"10.1.1.3" NullBooleanField

比BooleanField多了一个NULL状态 PhoneNumberField

美国格式电话号码 xxx-xxx-xxxx. CharField PositiveIntegerField

正整数 PositiveSmallIntegerField    一个小的正整数。根据数据库的设置 SlugField    小片断。

什么都可以。通常用来存url    SlugField 被暗指 maxlength=50 db_index=True

选项： prepopulate_from 一个用来自动生成slug的字段列表 SmallIntegerFieldTextField TimeField

选项： auto-population(可能不对) from DateField and DateTimeField URLField

选项： verify_exists  如果为True ，系统自动检查该url是否存在不为404 USStateField

两字符美国州简写 XMLField    保存xml数据。

选项：schema_path .指定relaxNG格式schema用来检验xml合法性

字段列表纵览表

字段名	参数	意义
AutoField		一个能够根据可用ID自增的 IntegerField
BooleanField		一个真／假（true/false）字段
CharField	(max_length)	一个字符串字段，适用于中小长度的字符串。对于长段的文字，请使用 TextField
CommaSeparatedIntegerField	(max_length)	一个用逗号分隔开的整数字段
DateField	([auto_now], [auto_now_add])	日期字段
DateTimeField		时间日期字段,接受跟 DateField 一样的额外选项
EmailField		一个能检查值是否是有效的电子邮件地址的 CharField
FileField	(upload_to)	一个文件上传字段
FilePathField	(path,[match],[recursive])	一个拥有若干可选项的字段，选项被限定为文件系统中某个目录下的文件名
FloatField	(max_digits,decimal_places)	一个浮点数，对应Python中的 float 实例
ImageField	(upload_to, [height_field] ,[width_field])	像 FileField 一样，只不过要验证上传的对象是一个有效的图片。
IntegerField		一个整数。
IPAddressField		一个IP地址，以字符串格式表示（例如： "24.124.1.30" ）。
NullBooleanField		就像一个 BooleanField ，但它支持 None /Null 。
PhoneNumberField		它是一个 CharField ，并且会检查值是否是一个合法的美式电话格式
PositiveIntegerField		和 IntegerField 类似，但必须是正值。
PositiveSmallIntegerField		与 PositiveIntegerField 类似，但只允许小于一定值的值,最大值取决于数据库.
SlugField		嵌条 就是一段内容的简短标签，这段内容只能包含字母、数字、下 划线或连字符。通常用于URL中
SmallIntegerField		和 IntegerField 类似，但是只允许在一个数据库相关的范围内的数值（通常是-32,768到 +32,767）
TextField		一个不限长度的文字字段
TimeField		时分秒的时间显示。它接受的可指定参数与 DateField 和 DateTimeField 相同。
URLField		用来存储URL的字段。
USStateField		美国州名称缩写，两个字母。
XMLField	(schema_path)	它就是一个 TextField ，只不过要检查值是匹配指定schema的合法XML。

通用字段参数列表（所有的字段类型都可以使用下面的参数，所有的都是可选的。）

参数名	意义
null	如果设置为 True 的话，Django将在数据库中存储空值为 NULL 。默认为 False 。
blank	如果是 True ，该字段允许留空，默认为 False 。
choices	一个包含双元素元组的可迭代的对象，用于给字段提供选项。
db_column	当前字段在数据库中对应的列的名字。
db_index	如果为 True ，Django会在创建表格（比如运行 manage.py syncdb ）时对这一列创建数据库索引。
default	字段的默认值
editable	如果为 False ，这个字段在管理界面或表单里将不能编辑。默认为 True 。
help_text	在管理界面表单对象里显示在字段下面的额外帮助文本。
primary_key	如果为 True ，这个字段就会成为模型的主键。
radio_admin	默认地，对于 ForeignKey 或者拥有 choices 设置的字段，Django管理界面会使用列表选择框（<select>）。如果 radio_admin 设置为 True 的话，Django就会使用单选按钮界面。
unique	如果是 True ，这个字段的值在整个表中必须是唯一的。
unique_for_date	把它的值设成一个 DataField 或者 DateTimeField 的字段的名称，可以确保字段在这个日期内不会出现重复值。
unique_for_month	和 unique_for_date 类似，只是要求字段在指定字段的月份内唯一。
unique_for_year	和 unique_for_date 及 unique_for_month 类似，只是时间范围变成了一年。
verbose_name	除 ForeignKey 、 ManyToManyField 和 OneToOneField 之外的字段都接受一个详细名称作为第一个位置参数。