19 01 18 dango 模型

定义属性

Django根据属性的类型确定以下信息：

• 当前选择的数据库支持字段的类型
• 渲染管理表单时使用的默认html控件
• 在管理站点最低限度的验证

django会为表创建自动增长的主键列，每个模型只能有一个主键列，如果使用选项设置某属性为主键列后django不会再创建自动增长的主键列。

默认创建的主键列属性为id，可以使用pk代替，pk全拼为primary key。

注意：pk是主键的别名，若主键名为id2，那么pk是id2的别名。

属性命名限制：

• 不能是python的保留关键字。
• 不允许使用连续的下划线，这是由django的查询方式决定的，在第4节会详细讲解查询。
• 定义属性时需要指定字段类型，通过字段类型的参数指定选项，语法如下：

属性=models.字段类型(选项)

字段类型

使用时需要引入django.db.models包，字段类型如下：

• AutoField：自动增长的IntegerField，通常不用指定，不指定时Django会自动创建属性名为id的自动增长属性。
• BooleanField：布尔字段，值为True或False。
• NullBooleanField：支持Null、True、False三种值。
• CharField(max_length=字符长度)：字符串。
  • 参数max_length表示最大字符个数。
• TextField：大文本字段，一般超过4000个字符时使用。
• IntegerField：整数。
• DecimalField(max_digits=None, decimal_places=None)：十进制浮点数。
  • 参数max_digits表示总位数。
  • 参数decimal_places表示小数位数。
• FloatField：浮点数。
• DateField[auto_now=False, auto_now_add=False])：日期。
  • 参数auto_now表示每次保存对象时，自动设置该字段为当前时间，用于"最后一次修改"的时间戳，它总是使用当前日期，默认为false。
  • 参数auto_now_add表示当对象第一次被创建时自动设置当前时间，用于创建的时间戳，它总是使用当前日期，默认为false。
  • 参数auto_now_add和auto_now是相互排斥的，组合将会发生错误。
• TimeField：时间，参数同DateField。
• DateTimeField：日期时间，参数同DateField。
• FileField：上传文件字段。
• ImageField：继承于FileField，对上传的内容进行校验，确保是有效的图片。

选项

通过选项实现对字段的约束，选项如下：

• null：如果为True，表示允许为空，默认值是False。
• blank：如果为True，则该字段允许为空白，默认值是False。
• 对比：null是数据库范畴的概念，blank是表单验证范畴的。
• db_column：字段的名称，如果未指定，则使用属性的名称。
• db_index：若值为True, 则在表中会为此字段创建索引，默认值是False。
• default：默认值。
• primary_key：若为True，则该字段会成为模型的主键字段，默认值是False，一般作为AutoField的选项使用。
• unique：如果为True, 这个字段在表中必须有唯一值，默认值是False。

字段查询

实现sql中where的功能，调用过滤器filter()、exclude()、get()，下面以filter()为例。

通过"属性名_id"表示外键对应对象的id值。

语法如下：

说明：属性名称和比较运算符间使用两个下划线，所以属性名不能包括多个下划线。

属性名称__比较运算符=值

条件运算符

1) 查询等

exact：表示判等。

例：查询编号为1的图书。

list=BookInfo.objects.filter(id__exact=1)
可简写为：
list=BookInfo.objects.filter(id=1)

2) 模糊查询

contains：是否包含。

说明：如果要包含%无需转义，直接写即可。

例：查询书名包含'传'的图书。

list = BookInfo.objects.filter(btitle__contains='传')

startswith、endswith：以指定值开头或结尾。

例：查询书名以'部'结尾的图书

list = BookInfo.objects.filter(btitle__endswith='部')

以上运算符都区分大小写，在这些运算符前加上i表示不区分大小写，如iexact、icontains、istartswith、iendswith.

3) 空查询

isnull：是否为null。

例：查询书名不为空的图书。

list = BookInfo.objects.filter(btitle__isnull=False)

4) 范围查询

in：是否包含在范围内。

例：查询编号为1或3或5的图书

list = BookInfo.objects.filter(id__in=[1, 3, 5])

5) 比较查询

gt、gte、lt、lte：大于、大于等于、小于、小于等于。

例：查询编号大于3的图书

list = BookInfo.objects.filter(id__gt=3)

不等于的运算符，使用exclude()过滤器。

例：查询编号不等于3的图书

list = BookInfo.objects.exclude(id=3)

6) 日期查询

year、month、day、week_day、hour、minute、second：对日期时间类型的属性进行运算。

例：查询1980年发表的图书。

list = BookInfo.objects.filter(bpub_date__year=1980)

例：查询1980年1月1日后发表的图书。

list = BookInfo.objects.filter(bpub_date__gt=date(1990, 1, 1))

F对象

之前的查询都是对象的属性与常量值比较，两个属性怎么比较呢？ 答：使用F对象，被定义在django.db.models中。

语法如下：

F(属性名)

例：查询阅读量大于等于评论量的图书。

from django.db.models import F
...
list = BookInfo.objects.filter(bread__gte=F('bcomment'))

可以在F对象上使用算数运算。

例：查询阅读量大于2倍评论量的图书。

list = BookInfo.objects.filter(bread__gt=F('bcomment') * 2)

Q对象

多个过滤器逐个调用表示逻辑与关系，同sql语句中where部分的and关键字。

例：查询阅读量大于20，并且编号小于3的图书。

list=BookInfo.objects.filter(bread__gt=20,id__lt=3)
或
list=BookInfo.objects.filter(bread__gt=20).filter(id__lt=3)

如果需要实现逻辑或or的查询，需要使用Q()对象结合|运算符，Q对象被义在django.db.models中。

语法如下：

Q(属性名__运算符=值)

例：查询阅读量大于20的图书，改写为Q对象如下。

from django.db.models import Q
...
list = BookInfo.objects.filter(Q(bread__gt=20))

Q对象可以使用&、|连接，&表示逻辑与，|表示逻辑或。

例：查询阅读量大于20，或编号小于3的图书，只能使用Q对象实现

list = BookInfo.objects.filter(Q(bread__gt=20) | Q(pk__lt=3))

Q对象前可以使用~操作符，表示非not。

例：查询编号不等于3的图书。

list = BookInfo.objects.filter(~Q(pk=3))

聚合函数

使用aggregate()过滤器调用聚合函数。聚合函数包括：Avg，Count，Max，Min，Sum，被定义在django.db.models中。

例：查询图书的总阅读量。

from django.db.models import Sum
...
list = BookInfo.objects.aggregate(Sum('bread'))

注意aggregate的返回值是一个字典类型，格式如下：

  {'聚合类小写__属性名':值}
  如:{'sum__bread':3}

使用count时一般不使用aggregate()过滤器。

例：查询图书总数。

list = BookInfo.objects.count()

注意count函数的返回值是一个数字。

查询集

查询集表示从数据库中获取的对象集合，在管理器上调用某些过滤器方法会返回查询集，查询集可以含有零个、一个或多个过滤器。过滤器基于所给的参数限制查询的结果，从Sql的角度，查询集和select语句等价，过滤器像where和limit子句。

返回查询集的过滤器如下：

• all()：返回所有数据。
• filter()：返回满足条件的数据。
• exclude()：返回满足条件之外的数据，相当于sql语句中where部分的not关键字。
• order_by()：对结果进行排序。

返回单个值的过滤器如下：

• get()：返回单个满足条件的对象
  • 如果未找到会引发"模型类.DoesNotExist"异常。
  • 如果多条被返回，会引发"模型类.MultipleObjectsReturned"异常。
• count()：返回当前查询结果的总条数。
• aggregate()：聚合，返回一个字典。

判断某一个查询集中是否有数据：

• exists()：判断查询集中是否有数据，如果有则返回True，没有则返回False。

两大特性

• 惰性执行：创建查询集不会访问数据库，直到调用数据时，才会访问数据库，调用数据的情况包括迭代、序列化、与if合用。
• 缓存：使用同一个查询集，第一次使用时会发生数据库的查询，然后把结果缓存下来，再次使用这个查询集时会使用缓存的数据。

限制查询集

可以对查询集进行取下标或切片操作，等同于sql中的limit和offset子句。

注意：不支持负数索引。

对查询集进行切片后返回一个新的查询集，不会立即执行查询。

如果获取一个对象，直接使用[0]，等同于[0:1].get()，但是如果没有数据，[0]引发IndexError异常，[0:1].get()如果没有数据引发DoesNotExist异常。

示例：获取第1、2项，运行查看。

list=BookInfo.objects.all()[0:2]

模型类关系

关系字段类型

关系型数据库的关系包括三种类型：

• ForeignKey：一对多，将字段定义在多的一端中。
• ManyToManyField：多对多，将字段定义在任意一端中。
• OneToOneField：一对一，将字段定义在任意一端中。
• 可以维护递归的关联关系，使用'self'指定，详见"自关联"。