多表查询是模型层的重要功能之一, Django提供了一套基于关联字段独特的解决方案.html
来自Django官方文档的模型示例:python
from django.db import models class Blog(models.Model): name = models.CharField(max_length=100) tagline = models.TextField() class Author(models.Model): name = models.CharField(max_length=50) email = models.EmailField() class Entry(models.Model): blog = models.ForeignKey(Blog) authors = models.ManyToManyField(Author) headline = models.CharField(max_length=255) body_text = models.TextField() pub_date = models.DateField() mod_date = models.DateField() n_comments = models.IntegerField() n_pingbacks = models.IntegerField() rating = models.IntegerField()
ForeignKey字段接受一个Model类做为参数, 类型与被参照的字段彻底相同:程序员
blog = models.ForeignKey(Blog)
关联到的关联对象的字段名称。默认地,Django 使用关联对象的主键。数据库
blog = models.ForeignKey(Blog, to_field=Blog.name)
Django Model的ForeignKey字段的主要功能是维护一个一对多的关系, 以进行关联查询.django
只有在db_constraint=True
时Django model才会在数据库上创建外键约束, 在该值为False时不创建约束.this
默认db_constraint=True
.spa
这个名称用于让关联的对象反查到源对象.code
若是你不想让Django 建立一个反向关联,请设置related_name 为 '+' 或者以'+' 结尾.htm
ForeignKey.related_query_name
以ForeignKey.related_name
做为默认值, 二者功能的具体说明请参见相关文档对象
若关系模型A包含与模型B关联的关联字段, 模型A的实例能够经过关联字段访问与其关联的模型B的实例:
>>> e = Entry.objects.get(id=2) >>> e.blog # Returns the related Blog object.
修改e.blog并调用save方法存入数据库
>>> e.blog = some_blog >>> e.save()
若是ForeignKey 字段有null=True 设置(即它容许NULL值),能够分配None来删除对应的关联性
>>> e = Entry.objects.get(id=2) >>> e.blog = None >>> e.save() # "UPDATE blog_entry SET blog_id = NULL ...;"
Django提供了一种使用双下划线__
的查询语法:
>>> Entry.objects.filter(blog__name='Beatles Blog')
被索引的关系模型能够访问全部参照它的模型的实例,如Entry.blog做为Blog的外键,默认状况下Blog.entry_set是包含全部参照Blog的Entry示例的查询集,可使用查询集API取出相应的实例。
>>>b = Blog.objects.get(id=1) >>>b.entry_set.all()
Entry.blog的related_name和related_query_name能够设置该查询集的名字。
来自Django官网的示例:
from django.db import models class Person(models.Model): name = models.CharField(max_length=50) class Group(models.Model): name = models.CharField(max_length=128) members = models.ManyToManyField(Person, through='Membership', through_fields=('group', 'person')) class Membership(models.Model): group = models.ForeignKey(Group) person = models.ForeignKey(Person) inviter = models.ForeignKey(Person, related_name="membership_invites") invite_reason = models.CharField(max_length=64)
Django 会自动建立一个表来管理多对多关系, 若要手动指定关联表则须要使用through关键字参数.
上文示例中Membership 有两个外键指向Person (person 和inviter),这使得关联关系含混不清并让Django 不知道使用哪个。
在这种状况下,必须使用through_fields 明确指定Django 应该使用哪些外键
through_fields 接收一个二元组('field1', 'field2'),其中field1 为指向定义ManyToManyField 字段的模型的外键名称(本例中为group),field2 为指向目标模型的外键的名称(本例中为person).
默认状况下,关联表的名称使用多对多字段的名称和包含这张表的模型的名称以及Hash值生成,如:memberShip_person_3c1f5
若要想要手动指定表的名称,可使用db_table
关键字参数指定.
下列API和ForeignKey中的同名API相同.
ManyToManyField.db_constraint
ManyToManyField.related_name
ManyToManyField.related_query_name
多对多关系和ForeignKey具备类似的API.
>>>e = Group.objects.get(id=3) >>>e.members.all() # Returns all members objects for this Group.
反向查询:
>>>a = Person.objects.get(id=1) >>>a.group_set.all()
一样related_name能够设置反向查询集的名称。
由于ManyToManyField自动维护关联表,程序员不便于直接访问.ManyToManyField提供了API用于添加和删除关联(即through表中的记录).
使用一个自动维护through表的模型做为示例:
class User(models.Model): user_id = models.IntegerField(primary_key=True) class Flight(models.Model): flight_id = models.IntegerField(primary_key=True) reserve = models.ManyToManyField(User, related_name='flight_reserve')
首先得到要进行关联的Flight和User实例:
flights = Flight.objects.filter(flight_id=flight_id) if flights.count() != 0: flight = flights[0] users = User.objects.filter(id=user_id) if users.count() != 0: user = users[0]
经过拥有关联字段的Flight实例进行添加关联操做:
flight.reserve.add(user) flight.save()
删除操做与这相似:
flight.reserve.remove(user) flight.save()
参考资料: