django中ORM模型常用的字段的使用方法
与数据类型相关的字段
CharField
作用:字符串字段,用于较短的字符串.
参数:CharField要求必须有一个参数maxlength,用于从数据库层和Django校验层限制该字段所允许的最大字符数.
IntegerField
作用:用于保存一个整数.
CommaSeparatedIntegerField
作用:用于存放逗号分隔的整数值.类似CharField,必须要有maxlength参数.
FloatField
作用:一个浮点数,必须提供两个参数:
参数:max_digits,总位数(不包括小数点和符号),decimal_places,小数位数.
示例1:要保存最大值为999(小数点后保存2位),你要这样定义字段:
models.FloatField(...,max_digits=5,decimal_places=2)
示例2:要保存最大值一百万(小数点后保存10位)的话,你要这样定义:
models.FloatField(...,max_digits=19,decimal_places=10)
admin用一个文本框(
与时间相关的字段
DateField
一个日期字段.共有下列额外的可选参数:
Argument 描述
auto_now 当对象被保存时,自动将该字段的值设置为当前时间.通常用于表示"last-modified"时间戳.
auto_now_add 当对象首次被创建时,自动将该字段的值设置为当前时间.通常用于表示对象创建时间.
(仅仅在admin中有意义...)
DateTimeField
一个日期时间字段.类似DateField支持同样的附加选项.
与布尔值相关的字段
BooleanField
Atrue/falsefield.admin用checkbox来表示此类字段.
NullBooleanField
类似BooleanField,不过允许NULL作为其中一个选项.推荐使用这个字段而不要用BooleanField加null=True选项
admin用一个选择框
与校验相关的字段
IPAddressField
一个字符串形式的IP地址,(i.e."24.124.1.30").
EmailField
一个带有检查Email合法性的CharField,不接受maxlength参数.
XMLField
一个校验值是否为合法XML的TextField,必须提供参数:schema_path,它是一个用来校验文本的RelaxNGschema#的文件系统路径.
与上传相关的字段
FileField
作用:
一个文件上传字段,要求一个必须有的参数
参数:
upload_to,一个用于保存上载文件的本地文件系统路径.这个路径必须包含strftime#formatting,
该格式将被上载文件的date/time替换(sothatuploadedfilesdon'tfillupthegivendirectory).
说明:
admin用一个
ImageField
作用:类似FileField,不过要校验上传对象是否是一个合法图片.
参数:它有两个可选参数:height_field和width_field,如果提供这两个参数,则图片将按提供的高度和宽度规格保存.
注意事项:
在一个model中使用FileField或ImageField需要以下步骤:
(1)在你的settings文件中,定义一个完整路径给MEDIA_ROOT以便让Django在此处保存上传文件.
(出于性能考虑,这些文件并不保存到数据库)定义MEDIA_URL作为该目录的公共URL.要确保该目录对WEB服务器用户帐号是可写的.
(2)在你的model中添加FileField或ImageField,并确保定义了upload_to选项,以告诉Django使用MEDIA_ROOT的哪个子目录保存上传文件.
你的数据库中要保存的只是文件的路径(相对于MEDIA_ROOT).
出于习惯你一定很想使用Django提供的get_<#fieldname>_url函数.
举例来说,如果你的ImageField叫作mug_shot,你就可以在模板中以{{object.#get_mug_shot_url}}这样的方式得到图像的绝对路径.
不好分类的字段
AutoField
一个IntegerField,添加记录时它会自动增长.你通常不需要直接使用这个字段;
自定义一个主键:my_id=models.AutoField(primary_key=True)
如果你不指定主键的话,系统会自动添加一个主键字段到你的model.
TextField
一个容量很大的文本字段.
admin用一个
URLField
作用:用于保存URL,若verify_exists参数为True(默认),给定的URL会预先检查是否存在(即URL是否被有效装入且没有返回404响应).
admin用一个
FilePathField
模型常用属性
常用字段:
在Django中,定义了一些Field来与数据库表中的字段类型来进行映射。以下将介绍那些常用的字段类型。会出现与上面重叠介绍。
AutoField:
映射到数据库中是int类型,可以有自动增长的特性。一般不需要使用这个类型,如果不指定主键,那么模型会自动的生成一个叫做id的自动增长的主键。如果你想指定一个其他名字的并且具有自动增长的主键,使用AutoField也是可以的。
BigAutoField:
64位的整形,类似于AutoField,只不过是产生的数据的范围是从1-9223372036854775807。
BooleanField:
在模型层面接收的是True/False。在数据库层面是tinyint类型。如果没有指定默认值,默认值是None。
CharField:
在数据库层面是varchar类型。在Python层面就是普通的字符串。这个类型在使用的时候必须要指定最大的长度,也即必须要传递max_length这个关键字参数进去。
DateField:
日期类型。在Python中是datetime.date类型,可以记录年月日。在映射到数据库中也是date类型。使用这个Field可以传递以下几个参数:
- auto_now:在每次这个数据保存的时候,都使用当前的时间。比如作为一个记录修改日期的字段,可以将这个属性设置为True。
- auto_now_add:在每次数据第一次被添加进去的时候,都使用当前的时间。比如作为一个记录第一次入库的字段,可以将这个属性设置为True。
DateTimeField:
日期时间类型,类似于DateField。不仅仅可以存储日期,还可以存储时间。映射到数据库中是datetime类型。这个Field也可以使用auto_now和auto_now_add两个属性。
TimeField:
时间类型。在数据库中是time类型。在Python中是datetime.time类型。
EmailField:
类似于CharField。在数据库底层也是一个varchar类型。最大长度是254个字符。
FileField:
用来存储文件的。这个请参考后面的文件上传章节部分。
ImageField:
用来存储图片文件的。这个请参考后面的图片上传章节部分。
FloatField:
浮点类型。映射到数据库中是float类型。
IntegerField:
整形。值的区间是-2147483648——2147483647。
BigIntegerField:
大整形。值的区间是-9223372036854775808——9223372036854775807。
PositiveIntegerField:
正整形。值的区间是0——2147483647。
SmallIntegerField:
小整形。值的区间是-32768——32767。
PositiveSmallIntegerField:
正小整形。值的区间是0——32767。
TextField:
大量的文本类型。映射到数据库中是longtext类型。
UUIDField:
只能存储uuid格式的字符串。uuid是一个32位的全球唯一的字符串,一般用来作为主键。
URLField:
类似于CharField,只不过只能用来存储url格式的字符串。并且默认的max_length是200。
Field的常用参数:
null:如果设置为True,Django将会在映射表的时候指定是否为空。默认是为False。在使用字符串相关的Field(CharField/TextField)的时候,官方推荐尽量不要使用这个参数,也就是保持默认值False。因为Django在处理字符串相关的Field的时候,即使这个Field的null=False,如果你没有给这个Field传递任何值,那么Django也会使用一个空的字符串""来作为默认值存储进去。因此如果再使用null=True,Django会产生两种空值的情形(NULL或者空字符串)。如果想要在表单验证的时候允许这个字符串为空,那么建议使用blank=True。如果你的Field是BooleanField,那么对应的可空的字段则为NullBooleanField。
blank:标识这个字段在表单验证的时候是否可以为空。默认是False。这个和null是有区别的,null是一个纯数据库级别的。而blank是表单验证级别的。db_column:这个字段在数据库中的名字。如果没有设置这个参数,那么将会使用模型中属性的名字。default:默认值。可以为一个值,或者是一个函数,但是不支持lambda表达式。并且不支持列表/字典/集合等可变的数据结构。primary_key:是否为主键。默认是False。unique:在表中这个字段的值是否唯一。一般是设置手机号码/邮箱等。更多Field参数请参考官方文档:https://docs.djangoproject.com/zh-hans/2.0/ref/models/fields/模型中Meta配置:对于一些模型级别的配置。我们可以在模型中定义一个类,叫做Meta。然后在这个类中添加一些类属性来控制模型的作用。比如我们想要在数据库映射的时候使用自己指定的表名,而不是使用模型的名称。那么我们可以在Meta类中添加一个db_table的属性。示例代码如下:
classBook(models.Model): name=models.CharField(max_length=20,null=False) desc=models.CharField(max_length=100,name='description',db_column="description1") classMeta: db_table='book_model'
以下将对Meta类中的一些常用配置进行解释。db_table:这个模型映射到数据库中的表名。如果没有指定这个参数,那么在映射的时候将会使用模型名来作为默认的表名。ordering:设置在提取数据的排序方式。后面章节会讲到如何查找数据。比如我想在查找数据的时候根据添加的时间排序,那么示例代码如下:
classBook(models.Model): name=models.CharField(max_length=20,null=False) desc=models.CharField(max_length=100,name='description',db_column="description1") pub_date=models.DateTimeField(auto_now_add=True) classMeta: db_table='book_model' ordering=['pub_date']
更多的配置后面会慢慢介绍到。官方文档:https://docs.djangoproject.com/en/2.0/ref/models/options/
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。