Django 系列博客(十三)
django 系列博客(十三)
前言
本篇博客介绍 django 中的常用字段和参数。
orm 字段
autofield
int 自增列,必须填入参数 primary_key=true。当 model 中如果没有自增列,则会自动创建一个列名为 id 的列。
integerfield
一个整数类型,范围在-2147483648 to 2147483647。
charfield
字符类型,必须提供max_length参数, max_length表示字符长度。
datefield
日期字段,日期格式 yyyy-mm-dd,相当于python中的datetime.date()实例。
datetimefield
日期时间字段,格式 yyyy-mm-dd hh:mm[:ss[.uuuuuu]][tz],相当于python中的datetime.datetime()实例。
常用和非常用字段
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) - 二进制类型
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
为该字段设置默认值。
auto_now_add
配置 auto_now_add=true,创建数据记录的时候会把当前时间添加到数据库。
auto_now
配置 auto_now=true,每次更新数据记录的时候会更新该字段。
具体意思
null 数据库中字段是否可以为空 db_column 数据库中字段的列名 db_tablespace 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'), ] )
关系字段
foreignkey
外键类型在orm中用来表示外键关联关系,一般把foreignkey字段设置在 '一对多'中'多'的一方。foreignkey可以和其他表做关联关系同时也可以和自身做关联关系。
to
设置要关联的表
to_field
设置要关联的表的字段
related_name
反向查询时,使用的字段名,用于代替原反向查询时的'表名_set'。
publish = foreignkey(blog, related_name='booklist')
db_constraint
是否在数据库中创建外键约束,默认为 true。
onetoonefield
一对一字段,通常使用一对一字段用来扩展已有字段。
一对一的关联关系多用在当一张表的不同字段查询频次差距过大的情况下,将本可以存储在一张表的字段拆开放置在两张表中,然后将两张表建立一对一的关联关系。
class author(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) age = models.integerfield(default=18) class authordetail(models.model): id = models.autofield(primary_key=true) addr = models.charfield(max_length=32) author = models.onetoonefield(to=author, to_field='id')
to
设置要关联的表
to_field
设置要关联的字段。
on_delete
级联删除选项
manytomanyfield
用于表示多对多的关联关系。在数据库中通过第三张表来建立关联关系。
to
设置要关联的表
related_name
反向查询时,使用的字段名,用于代替原反向查询时的'表名_set'。
symmetrical
仅用于多对多自关联时,指定内部是否创建反向操作的字段。默认为 true。
class person(models.model): name = models.charfield(max_length=16) friends = models.manytomanyfield("self")
此时,person 对象没有 person_set属性。
class person(models.model): name = models.charfield(max_length=16) friends = models.manytomanyfield("self", symmetrical=false)
此时,person 对象可以使用 person_set 属性进行反向查询。
through
在使用 manytomanyfield 字段时,django 将自动生成一张表来管理多对多的关联关系。但是当我们手动创建第三张表来管理多对多关系时,就需要通过 through 来指定第三张表的表名。
class book(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) price = models.decimalfield(max_digits=5, decimal_places=2) publish_date = models.datefield() publish = models.foreignkey(to='publish', to_field='id') authors = models.manytomanyfield(to='author', through='book2author', through_fields=('book', 'author')) class author(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) gender = models.smallintegerfield() author_detail = models.onetoonefield(to='authordetail', to_field='id', on_delete=models.cascade) class book2author(models.model): id = models.autofield(primary_key=true) book = models.foreignkey(to=book) author = models.foreignkey(to=author)
through_field
设置要关联的字段:关联字段在book2author中,从这个表到book 表,所以把 book 写在前面。
db_table
默认创建第三张表时,设置表的名字。
多对多关联关系的三种方式
方式一:手动创建第三张表
class book(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) price = models.decimalfield(max_digits=5, decimal_places=2) publish_date = models.datefield() publish = models.foreignkey(to='publish', to_field='id') class author(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) gender = models.smallintegerfield() author_detail = models.onetoonefield(to='authordetail', to_field='id', on_delete=models.cascade) class book2author(models.model): id = models.autofield(primary_key=true) book = models.foreignkey(to=book) author = models.foreignkey(to=author)
方式二:通过 manytomanyfield 自动创建第三张表
class book(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) price = models.decimalfield(max_digits=5, decimal_places=2) publish_date = models.datefield() publish = models.foreignkey(to='publish', to_field='id') authors = models.manytomanyfield(to='author') class author(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) gender = models.smallintegerfield() author_detail = models.onetoonefield(to='authordetail', to_field='id', on_delete=models.cascade)
方式三:设置 manytomanyfield 并指定手动创建第三张表
class book(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) price = models.decimalfield(max_digits=5, decimal_places=2) publish_date = models.datefield() publish = models.foreignkey(to='publish', to_field='id') class author(models.model): id = models.autofield(primary_key=true) name = models.charfield(max_length=32) gender = models.smallintegerfield() author_detail = models.onetoonefield(to='authordetail', to_field='id', on_delete=models.cascade) class book2author(models.model): id = models.autofield(primary_key=true) book = models.foreignkey(to=book) author = models.foreignkey(to=author)
当业务需要在第三张关系表中存储额外的字段时,就要使用第三种方式。
这样创建的第三张表无法使用 set、add、remove、clear方法来管理对多多关系,需要通过第三张表来进行增、删、改,查询一样。
自定义字段
class fixedcharfield(models.field): """ 自定义的char类型的字段类 """ def __init__(self, max_length, *args, **kwargs): self.max_length = max_length super(fixedcharfield, self).__init__(max_length=max_length, *args, **kwargs) def db_type(self, connection): """ 限定生成数据库表的字段类型为char,长度为max_length指定的值 """ return 'char(%s)' % self.max_length class class(models.model): id = models.autofield(primary_key=true) title = models.charfield(max_length=25) # 使用自定义的char类型的字段 cname = fixedcharfield(max_length=25)
上一篇: 资深网购专家告诉你,扫地机器人十大排名哪个牌子效果好?
下一篇: 2013年云计算面临的九大安全威胁
推荐阅读
-
Django 系列博客(十三)
-
Flutter 即学即用系列博客——07 RenderFlex overflowed 引发的思考
-
ASP系列讲座(十三)向浏览器传送脚本
-
Django写的博客工具?
-
Web 前端开发精华文章推荐(HTML5、CSS3、jQuery)【系列二十三】_html/css_WEB-ITnose
-
JavaScript 系列博客(三)
-
基于django的个人博客网站建立(四)
-
Flutter 即学即用系列博客——01 环境搭建
-
Python+Django+SAE系列课程13-MySQL记录的添删改
-
Django3.0+Python3.8+MySQL8.0 个人博客搭建六|数据库结构设计