Django 常用字段和参数
程序员文章站
2022-07-01 23:37:03
一.ORM字段 | 类型 | 说明 | | | | | AutoField | 一个自动增加的整数类型字段。通常你不需要自己编写它,Django会自动帮你添加字段:\ ,这是一个自增字段,从1开始计数。如果你非要自己设置主键,那么请务必将字段设置为\ 。Django在一个模型中只允许有一个自增字段, ......
一.orm字段
类型 | 说明 |
---|---|
autofield | 一个自动增加的整数类型字段。通常你不需要自己编写它,django会自动帮你添加字段:`id = models.autofield(primary_key=true)`,这是一个自增字段,从1开始计数。如果你非要自己设置主键,那么请务必将字段设置为`primary_key=true。django在一个模型中只允许有一个自增字段,并且该字段必须为主键! | | bigautofield | (1.10新增)64位整数类型自增字段,数字范围更大,从1到9223372036854775807 | | bigintegerfield | 64位整数字段(看清楚,非自增),类似integerfield ,-9223372036854775808 到9223372036854775807。在django的模板表单里体现为一个textinput标签。 | | binaryfield | 二进制数据类型。使用受限,少用。 | | **booleanfield** | 布尔值类型。默认值是none。在html表单中体现为checkboxinput标签。如果要接收null值,请使用nullbooleanfield。 | | **charfield** | 字符串类型。必须接收一个max_length参数,表示字符串长度不能超过该值。默认的表单标签是input text。最常用的filed,没有之一! | | commaseparatedintegerfield | 逗号分隔的整数类型。必须接收一个max_length参数。常用于表示较大的金额数目,例如1,000,000元。 | | **datefield** | \ class datefield(auto_now=false, auto_now_add=false, options)`日期类型。一个python中的datetime.date的实例。在html中表现为textinput标签。在admin后台中,django会帮你自动添加一个js的日历表和一个“today”快捷方式,以及附加的日期合法性验证。两个重要参数:(参数互斥,不能共存)`auto_now`:每当对象被保存时将字段设为当前日期,常用于保存最后修改时间。`auto_now_add`:每当对象被创建时,设为当前日期,常用于保存创建日期(注意,它是不可修改的)。设置上面两个参数就相当于给field添加了`editable=false`和`blank=true`属性。如果想具有修改属性,请用default参数。例子:`pub_time = models.datefield(auto_now_add=true),自动添加发布时间。 | | datetimefield | 日期时间类型。python的datetime.datetime的实例。与datefield相比就是多了小时、分和秒的显示,其它功能、参数、用法、默认值等等都一样。 | | decimalfield | 固定精度的十进制小数。相当于python的decimal实例,必须提供两个指定的参数!参数\ max_digits`:最大的位数,必须大于或等于小数点位数 。`decimal_places`:小数点位数,精度。 当`localize=false`时,它在html表现为numberinput标签,否则是text类型。例子:储存最大不超过999,带有2位小数位精度的数,定义如下:`models.decimalfield(..., max_digits=5, decimal_places=2)。 | | durationfield | 持续时间类型。存储一定期间的时间长度。类似python中的timedelta。在不同的数据库实现中有不同的表示方法。常用于进行时间之间的加减运算。但是小心了,这里有坑,postgresql等数据库之间有兼容性问题! | | **emailfield** | 邮箱类型,默认max_length最大长度254位。使用这个字段的好处是,可以使用django内置的emailvalidator进行邮箱地址合法性验证。 | | **filefield** | \ class filefield(upload_to=none, max_length=100, options)上传文件类型,后面单独介绍。 | | filepathfield | 文件路径类型,后面单独介绍 | | floatfield | 浮点数类型,参考整数类型 | | **imagefield** | 图像类型,后面单独介绍。 | | **integerfield** | 整数类型,最常用的字段之一。取值范围-2147483648到2147483647。在html中表现为numberinput标签。 | | **genericipaddressfield** | \ class genericipaddressfield(protocol='both', unpack_ipv4=false, **options)[source]`,ipv4或者ipv6地址,字符串形式,例如`192.0.2.30或者 2a02:42fe::4`在html中表现为textinput标签。参数`protocol默认值为‘both’,可选‘ipv4’或者‘ipv6’,表示你的ip地址类型。 | | nullbooleanfield | 类似布尔字段,只不过额外允许\ null`作为选项之一。 |
positiveintegerfield | 正整数字段,包含0,最大2147483647。 |
positivesmallintegerfield | 较小的正整数字段,从0到32767。 |
slugfield | slug是一个新闻行业的术语。一个slug就是一个某种东西的简短标签,包含字母、数字、下划线或者连接线,通常用于urls中。可以设置max_length参数,默认为50。 |
smallintegerfield | 小整数,包含-32768到32767。 |
textfield | 大量文本内容,在html中表现为textarea标签,最常用的字段类型之一!如果你为它设置一个max_length参数,那么在前端页面中会受到输入字符数量限制,然而在模型和数据库层面却不受影响。只有charfield才能同时作用于两者。 |
timefield | 时间字段,python中datetime.time的实例。接收同datefield一样的参数,只作用于小时、分和秒。 |
urlfield | 一个用于保存url地址的字符串类型,默认最大长度200。 |
uuidfield | 用于保存通用唯一识别码(universally unique identifier)的字段。使用python的uuid类。在postgresql数据库中保存为uuid类型,其它数据库中为char(32)。这个字段是自增主键的最佳替代品,后面有例子展示。 |
orm字段与数据库实际字段的对应关系
'autofield': 'integer auto_increment', 'bigautofield': 'bigint auto_increment', 'binaryfield': 'longblob', 'booleanfield': 'bool', 'charfield': 'varchar(%(max_length)s)', 'commaseparatedintegerfield': 'varchar(%(max_length)s)', 'datefield': 'date', 'datetimefield': 'datetime', 'decimalfield': 'numeric(%(max_digits)s, %(decimal_places)s)', 'durationfield': 'bigint', 'filefield': 'varchar(%(max_length)s)', 'filepathfield': 'varchar(%(max_length)s)', 'floatfield': 'double precision', 'integerfield': 'integer', 'bigintegerfield': 'bigint', 'ipaddressfield': 'char(15)', 'genericipaddressfield': 'char(39)', 'nullbooleanfield': 'bool', 'onetoonefield': 'integer', 'positiveintegerfield': 'integer unsigned', 'positivesmallintegerfield': 'smallint unsigned', 'slugfield': 'varchar(%(max_length)s)', 'smallintegerfield': 'smallint', 'textfield': 'longtext', 'timefield': 'time', 'uuidfield': 'char(32)',
二.orm字段参数
null:用于表示某个字段可以为空 unique:如果设置为unique=true 则该字段在此表中必须是唯一的 db_index:如果db_index=true则代表着为此字段设置索引 default:为该字段设置默认值
datefield和datetimefield
auto_now_add:配置auto_now_add=true,创建数据记录的适合会把当前时间添加到数据库 auto_now:配置auto_now=true,每次更新数据记录的时候会更新该字段
三.关系型字段
1.一对多(foreignkey)
外键类型在orm中用来表示外键关联关系,一般把foreignkey字段设置在一对多关系中'多'的那一方。
foreignkey可以和其他表做关联关系同时也可以和自身做关联关系
参数:
to:设置要关联的表 to_field:设置要关联的表的字段 related_name:反向操作时,使用的字段名,用于代替反向查询时的"表名_set" related_query_name:反向查询操作时,使用的连接前缀,用于替换表名 on_delete:当删除关联表中的数据时,当前表与其关联的行为 参数值: models.cascade:表示删除关联数据,与之关联也删除 models.do_nothing:表示删除关联数据,什么也不做 models.protect:删除关联数据,引发错误protectederror models.set_default:将外键字段设为默认值,只有当字段设置了默认值,才能使用 models.set_null:将外键字段设为null,只有当字段设置了null=true时,才能使用 db_constraint:是否在数据库中创建外键约束,默认为true
2.一对一(onetoonefield)
一对一关系非常类似具有unique=true属性的外键关系,但是反向关联对象只有一个,这种关系类型多数用于当一个模型需要从别的模型扩展而来的情况.
该关系的第一位置参数为关联的模型,用法和前面的一对多类似
to:设置要关联的表 to_field:设置要关联的表的字段 on_delete:同foreignkey
3.多对多(manytomanyfield)
多对多关系在数据库中也是非常常见的关系类型,多对多的字段可以定义在任何一方.
to:设置要关联的表 related_name:同foreignkey related_query_name:同foreignkey symmetrical:仅用于多对多自关联时,指定内部是否创建反向操作的字段,默认为true through:在使用manytomanyfield字段时,django将自动生成一张表来管理多对多的关联关系,但我们也可以手动创建第三张表来管理多对多关系,此时就需要通过through来指定第三张表的表名 through_fields:设置关联的字段 db_table:默认创建第三张表时,数据库中表的名称
四.元信息
orm对应的类里面包含另一个meta类,而meta类封装了一些数据库的信息,主要字段有: db_table:orm在数据库中的表名默认是app_类名,可以通过db_table来设置 index_together:联合索引 unique_together:联合唯一索引 ordering:指定默认按什么字段排序