django 模型——model 字段

Django 经过 models 实现数据库的建立、修改、删除等操做git

模型中通常经常使用的类型的清单

AutoField

一个自动递增的整型字段,添加记录时它会自动增加。你一般不须要直接使用这个字段;若是你不指定主键的话,系统会自动添加一个主键字段到你的model。
正则表达式

BooleanField:

布尔字段,管理工具里会自动将其描述为checkbox。数据库

CharField:

字符串字段,单行输入,用于较短的字符串,如要保存大量文本, 使用 TextField,CharField有一个必填参数:django

CharField.max_length:字符的最大长度,django会根据这个参数在数据库层和校验层限制该字段所容许的最大字符数。服务器

 

TextField:

一个容量很大的文本字段, admin 管理界面用 <textarea>多行编辑框表示该字段数据。ide

 

CommaSeparatedIntegerField:

用于存放逗号分隔的整数值。相似 CharField,必须maxlength 参数。函数

 

DateField:

日期字段,admin 用一个文本框 <input type=”text”> 来表示该字段数据(附带一个 JavaScript 日历和一个”Today”快捷按键。有下列额外的可选参数:工具

auto_now:当对象被保存时,自动将该字段的值设置为当前时间.一般用于表示 “last-modified” 时间戳;
auto_now_add:当对象首次被建立时,自动将该字段的值设置为当前时间.一般用于表示对象建立时间。性能

DateTimeField:

相似 DateField 支持一样的附加选项url

EmailField:

一个带有检查 Email 合法性的 CharField,不接受 maxlength 参数。

FileField:

一个文件上传字段。 要求一个必须有的参数: upload_to, 一个用于保存上载文件的本地文件系统路径。 这个路径必须包含 strftime formatting, 该格式将被上载文件的 date/time 替换(so that uploaded files don’t fill up the given directory)。在一个 model 中使用 FileField 或 ImageField 须要如下步骤:在你的 settings 文件中, 定义一个完整路径给 MEDIA_ROOT 以便让 Django在此处保存上传文件。 (出于性能考虑,这些文件并不保存到数据库。) 定义 MEDIA_URL 做为该目录的公共 URL。 要确保该目录对 WEB 服务器用户账号是可写的。在你的 model 中添加 FileField 或 ImageField, 并确保定义了 upload_to 选项,以告诉 Django 使用 MEDIA_ROOT 的哪一个子目录保存上传文件。你的数据库中要保存的只是文件的路径(相对于 MEDIA_ROOT)。 出于习惯你必定很想使用 Django 提供的 get_<fieldname>_url 函数。举例来讲,若是你的 ImageField 叫做 mug_shot, 你就能够在模板中以 {{ object。get_mug_shot_url }} 这样的方式获得图像的绝对路径。

FilePathField:

选择指定目录按限制规则选择文件,有三个参数可选, 其中”path”必需的,这三个参数能够同时使用, 参数描述:

path:必需参数,一个目录的绝对文件系统路径。 FilePathField 据此获得可选项目。 Example: “/home/images”;
match:可选参数, 一个正则表达式, 做为一个字符串, FilePathField 将使用它过滤文件名。 注意这个正则表达式只会应用到 base filename 而不是路径全名。

Example: “foo。*\。txt^”, 将匹配文件 foo23.txt 却不匹配 bar.txt 或 foo23.gif;
recursive:可选参数, 是否包括 path 下所有子目录,True 或 False,默认值为 False。

match 仅应用于 base filename, 而不是路径全名。 如:FilePathField(path=”/home/images”, match=”foo.*”, recursive=True)…会匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif

FloatField:浮点型字段。 必须提供两个 参数, 参数描述:

max_digits:总位数(不包括小数点和符号)
decimal_places:小数位数。如:要保存最大值为 999 (小数点后保存2位),你要这样定义字段:models.FloatField(…,max_digits=5, decimal_places=2),要保存最大值一百万(小数点后保存10位)的话,你要这样定义:models.FloatField(…,max_digits=19, decimal_places=10)

ImageField:

相似 FileField, 不过要校验上传对象是不是一个合法图片。它有两个可选参数:height_field 和 width_field,若是提供这两个参数,则图片将按提供的高度和宽度规格保存。 该字段要求 Python Imaging 库。

IntegerField:

用于保存一个整数。

IPAddressField:

一个字符串形式的 IP 地址, (如 “202.1241.30″)。

NullBooleanField:

相似 BooleanField, 不过容许 NULL 做为其中一个选项。 推荐使用这个字段而不要用 BooleanField 加 null=True 选项。 admin 用一个选择框 <select> (三个可选择的值: “Unknown”, “Yes” 和 “No” ) 来表示这种字段数据。

PhoneNumberField:

一个带有合法美国风格电话号码校验的 CharField(格式:XXX-XXX-XXXX)。(中国可能很差用)

PositiveIntegerField:

相似 IntegerField, 但取值范围为非负整数(这个字段应该是容许0值的…能够理解为无符号整数)

PositiveSmallIntegerField:

正小整型字段,相似 PositiveIntegerField, 取值范围较小(数据库相关)SlugField“Slug” 是一个报纸术语。 slug 是某个东西的小小标记(短签), 只包含字母,数字,下划线和连字符。它们一般用于URLs。 若你使用 Django 开发版本,你能够指定 maxlength。 若 maxlength 未指定, Django 会使用默认长度: 50,它接受一个额外的参数:prepopulate_from: 来源于slug的自动预置列表

SlugField:

是一个报纸术语. slug 是某个东西的小小标记(短签), 只包含字母,数字,下划线和连字符.它们一般用于URLs。

SmallIntegerField:

相似 IntegerField, 不过只容许某个取值范围内的整数。(依赖数据库)

TimeField:

时间字段,相似于 DateField 和 DateTimeField。

URLField:

用于保存 URL。 若 verify_exists 参数为 True (默认), 给定的 URL 会预先检查是否存在(即URL是否被有效装入且没有返回404响应)。

USStateField:

美国州名缩写,由两个字母组成(天朝人民无视)。

XMLField:

XML字符字段,校验值是否为合法XML的 TextField,必须提供参数:schema_path:校验文本的 RelaxNG schema 的文件系统路径。

附:Field 选项

    • null :缺省设置为false.一般不将其用于字符型字段上,好比CharField,TextField上.字符型字段若是没有值会返回空字符串。
    • blank:该字段是否能够为空。若是为假,则必须有值
    • choices:一个用来选择值的2维元组。第一个值是实际存储的值,第二个用来方便进行选择。如SEX_CHOICES= ((‘F’,'Female’),(‘M’,'Male’),)
    • core:db_column,db_index 若是为真将为此字段建立索引
    • default:设定缺省值
    • editable:若是为假,admin模式下将不能改写。缺省为真
    • help_text:admin模式下帮助文档
    • primary_key:设置主键,若是没有设置django建立表时会自动加上:
1 id = meta.AutoField('ID', primary_key=True)
2 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和pub_date两个都相同的数据重复出现
    • title = meta.CharField(maxlength=30,unique_for_date=’pub_date’)
    • unique_for_month / unique_for_year:用法同上
    • validator_list:有效性检查。非有效产生 django.core.validators.ValidationError 错误

 快速查询列表

 AutoField(Field) - int自增列,必须填入参数 primary_key=True BigAutoField(AutoField) - bigint自增列,必须填入参数 primary_key=True 注:当model中若是没有自增列,则自动会建立一个列名为id的列 from django.db import models class UserInfo(models.Model): # 自动建立一个列名为id的且为自增的整数列
            username = models.CharField(max_length=32) class Group(models.Model): # 自定义自增列
            nid = models.AutoField(primary_key=True) name = models.CharField(max_length=32) SmallIntegerField(IntegerField): - 小整数 -32768 ~ 32767 PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正小整数 0 ~ 32767 IntegerField(Field) - 整数列(有符号的) -2147483648 ~ 2147483647 PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正整数 0 ~ 2147483647 BigIntegerField(IntegerField): - 长整型(有符号的) -9223372036854775808 ~ 9223372036854775807 BooleanField(Field) - 布尔值类型 NullBooleanField(Field): - 能够为空的布尔值 CharField(Field) - 字符类型 - 必须提供max_length参数, max_length表示字符长度 TextField(Field) - 文本类型 EmailField(CharField): - 字符串类型,Django Admin以及ModelForm中提供验证机制 IPAddressField(Field) - 字符串类型,Django Admin以及ModelForm中提供验证 IPV4 机制 GenericIPAddressField(Field) - 字符串类型,Django Admin以及ModelForm中提供验证 Ipv4和Ipv6 - 参数: protocol,用于指定Ipv4或Ipv6, 'both',"ipv4","ipv6" unpack_ipv4, 若是指定为True,则输入::ffff:192.0.2.1时候,可解析为192.0.2.1,开启刺功能,须要protocol="both" URLField(CharField) - 字符串类型,Django Admin以及ModelForm中提供验证 URL SlugField(CharField) - 字符串类型,Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、链接符(减号) CommaSeparatedIntegerField(CharField) - 字符串类型,格式必须为逗号分割的数字 UUIDField(Field) - 字符串类型,Django Admin以及ModelForm中提供对UUID格式的验证 FilePathField(Field) - 字符串,Django Admin以及ModelForm中提供读取文件夹下文件的功能 - 参数: path, 文件夹路径 match=None, 正则匹配 recursive=False, 递归下面的文件夹 allow_files=True, 容许文件 allow_folders=False, 容许文件夹 FileField(Field) - 字符串,路径保存在数据库,文件上传到指定目录 - 参数: upload_to = "" 上传文件的保存路径 storage = None 存储组件,默认django.core.files.storage.FileSystemStorage ImageField(FileField) - 字符串,路径保存在数据库,文件上传到指定目录 - 参数: upload_to = "" 上传文件的保存路径 storage = None 存储组件,默认django.core.files.storage.FileSystemStorage width_field=None, 上传图片的高度保存的数据库字段名(字符串) height_field=None 上传图片的宽度保存的数据库字段名(字符串) DateTimeField(DateField) - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] DateField(DateTimeCheckMixin, Field) - 日期格式      YYYY-MM-DD TimeField(DateTimeCheckMixin, Field) - 时间格式 HH:MM[:ss[.uuuuuu]] DurationField(Field) - 长整数,时间间隔,数据库中按照bigint存储,ORM中获取的值为datetime.timedelta类型 FloatField(Field) - 浮点型 DecimalField(Field) - 10进制小数 - 参数: max_digits,小数总长度 decimal_places,小数位长度 BinaryField(Field) - 二进制类型
字段列表
 null 数据库中字段是否能够为空 db_column 数据库中字段的列名 default 数据库中字段的默认值 primary_key 数据库中字段是否为主键 db_index 数据库中字段是否能够创建索引 unique 数据库中字段是否能够创建惟一索引 unique_for_date 数据库中字段【日期】部分是否能够创建惟一索引 unique_for_month 数据库中字段【月】部分是否能够创建惟一索引 unique_for_year 数据库中字段【年】部分是否能够创建惟一索引 verbose_name Admin中显示的字段名称 blank Admin中是否容许用户输入为空 editable Admin中是否能够编辑 help_text Admin中该字段的提示信息 choices Admin中显示选择框的内容,用不变更的数据放在内存中从而避免跨表操做 如:gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1) error_messages 自定义错误信息(字典类型),从而定制想要显示的错误信息; 字典健:null, blank, invalid, invalid_choice, unique, and unique_for_date 如:{'null': "不能为空.", 'invalid': '格式错误'} validators 自定义错误验证(列表类型),从而定制想要的验证规则 from django.core.validators import RegexValidator from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\ MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator 如: test = models.CharField( max_length=32, error_messages={ 'c1': '优先错信息1', 'c2': '优先错信息2', 'c3': '优先错信息3', }, validators=[ RegexValidator(regex='root_\d+', message='错误了', code='c1'), RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'), EmailValidator(message='又错误了', code='c3'), ] )
字段参数
相关文章
相关标签/搜索