Django model字段类型详解

el/2024/7/24 1:23:41

Django 通过 models 实现数据库的创建、修改、删除等操作,本文为模型中一般常用的类型的清单,便于查询和使用:

AutoField:一个自动递增的整型字段,添加记录时它会自动增长。你通常不需要直接使用这个字段;如果你不指定主键的话,系统会自动添加一个主键字段到你的model。(参阅自动主键字段)

 

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

 

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

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

 

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

该字段数据。

 

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

 

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

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

 

DateTimeField:类似 DateField 支持同样的附加选项。

 

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创建表时会自动加上:
1id = meta.AutoField('ID', primary_key=True)
2primary_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 错误

字段选项¶

每个字段有一些特有的参数,详见模型字段参考。例如,CharField(和它的派生类)需要max_length 参数来指定VARCHAR 数据库字段的大小。

还有一些适用于所有字段的通用参数。 这些参数在参考中有详细定义,这里我们只简单介绍一些最常用的:

null

如果为True,Django 将会把数据库中空值保存为NULL。默认值是 False.

blank

如果为True,该字段允许为空值,默认为False。

要注意,这与 null 不同。null纯粹是数据库范畴,指数据库中字段内容是否允许为空,而 blank 是表单数据输入验证范畴的。如果一个字段的blank=True,表单的验证将允许输入一个空值。如果字段的blank=False,该字段就是必填的。

primary_key

如果为True,那么这个字段就是模型的主键。如果你没有指定任何一个字段的primary_key=True,Django 就会自动添加一个IntegerField 字段做为主键,所以除非你想覆盖默认的主键行为,否则没必要设置任何一个字段的primary_key=True。

unique

如果该值设置为 True, 这个数据字段在整张表中必须是唯一的再说一次,这些仅仅是常用字段的简短介绍, 要了解详细内容,请查看 通用 model 字段选项参考.

自增主键字段¶

默认情况下,Django 会给每个模型添加下面这个字段:

id = models.AutoField(primary_key=True)

这是一个自增主键字段。

如果你想指定一个自定义主键字段,只要在某个字段上指定 primary_key=True 即可。如果 Django 看到你显式地设置了 Field.primary_key,就不会自动添加 id 列。

每个模型只能有一个字段指定primary_key=True(无论是显式声明还是自动添加)。

 


http://www.ngui.cc/el/5557135.html

相关文章

django的request、session没有获取到值,赋默认值

接受request的数据 从post中取得数据&#xff0c;如果不存在则默认值为1 pageNumber request.POST.get(pageNumber,1) 从get中取得数据&#xff0c;如果不存在则默认值为1 pageNumber request.GET.get(pageNumber,1) 从所有请求中取得数据&#xff0c;如果不存在则默认值为1 …

你知道 Linux 内核是如何构建的吗?

介绍 我不会告诉你怎么在自己的电脑上去构建、安装一个定制化的 Linux 内核&#xff0c;这样的资料太多了&#xff0c;它们会对你有帮助。本文会告诉你当你在内核源码路径里敲下make 时会发生什么。 当我刚刚开始学习内核代码时&#xff0c;Makefile 是我打开的第一个文件&…

JS return false 与 return true(解决表单重复提交的问题)

在大多数情况下,为事件处理函数返回false,可以防止默认事件的行为。 例如,默认情况下点击一个<a>元素,页面会跳转到该元素href属性指定的页。Return False 就相当于终止符&#xff0c;Return True 就相当于执行符。在js中return false的作用一般是用来取消默认动作的。比…

centos6.5下安装django

第一步&#xff1a; 安装pip. 第二步&#xff1a; centos6.5下默认python版本为2.6.x 必须升级python升级过程&#xff1a; 1、下载Python 2.7源码&#xff1a; wget http://www.python.org/ftp/python/2.7.2/Python-2.7.2.tgz 下载 2、解压源码包&#xff1a; tar -zxvf…

django Error loading MySQLdb module:No module named MySQLdb

第一步&#xff1a; django链接数据库报错(在命令行运行&#xff1a;manage.py syncdb)&#xff1a; Error loading MySQLdb module:No module named MySQLdb检查setting.py中的DATABASESDATABASES { default: { ENGINE: django.db.backends.mysql, # Add postgres…

Java 多线程处理任务的封装

原文&#xff1a;http://www.codeceo.com/article/java-thread-wrap.html 最近公司项目很多地方使用多线程处理一些任务&#xff0c;逻辑代码和java多线程处理代码混合在一起&#xff0c;造成代码的可读性超级差&#xff0c;现在把Java多线程相关的处理抽出来&#xff0c;方面代…

如何用Java编写一段代码引发内存泄露

原文&#xff1a;http://www.codeceo.com/article/java-code-stack-overflow.html 本文来自StackOverflow问答网站的一个热门讨论&#xff1a;如何用Java编写一段会发生内存泄露的代码。 Q&#xff1a;刚才我参加了面试&#xff0c;面试官问我如何写出会发生内存泄露的Java代码…

centos7安装mysql5.x

1.rpm -qa | grep mysql qt-mysql-4.8.5-11.el7.x86_64 pcp-pmda-mysql-3.10.6-2.el7.x86_64 akonadi-mysql-1.9.2-4.el7.x86_64 2.卸载上面三个包 rpm -e akonadi-mysql rpm -e qt-mysql rpm -e pcp-pmda-mysql 强制卸载&#xff0c;添加--nodeps 例如: rpm -e…

用Nginx实现Session共享的均衡负载

本文由码农网 – 邱康原创&#xff0c;转载请看清文末的转载要求&#xff0c;欢迎参与我们的付费投稿计划&#xff01; 前言 大学三年多&#xff0c;也做个几个网站和APP后端&#xff0c;老是被人问到&#xff0c;如果用户多了服务器会不会挂&#xff0c;总是很尴尬的回答&…

centos系统查看系统版本、内核版本、系统位数、cpu个数、核心数、线程数

centos查看系统版本 cat /etc/redhat-release CentOS Linux release 7.2.1511 (Core) 1)查看centos内核的版本&#xff1a; [rootlocalhost ~]# cat /proc/version Linux version 2.6.18-194.el5 (mockbuildbuilder10.centos.org) (gcc version 4.1.2 20080704 (Red Hat…