Django-1.11中文文档——操作关联对象

关联对象参考

写在最前面——基础示例模型如下：

from django.db import models

class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()

    def __str__(self):              # __unicode__ on Python 2
        return self.name

class Author(models.Model):
    name = models.CharField(max_length=200)
    email = models.EmailField()

    def __str__(self):              # __unicode__ on Python 2
        return self.name

class Entry(models.Model):
    blog = models.ForeignKey(Blog, on_delete=models.CASCADE)
    headline = models.CharField(max_length=255)
    body_text = models.TextField()
    pub_date = models.DateField()
    mod_date = models.DateField()
    authors = models.ManyToManyField(Author)
    n_comments = models.IntegerField()
    n_pingbacks = models.IntegerField()
    rating = models.IntegerField()

    def __str__(self):              # __unicode__ on Python 2
        return self.headline

class RelatedManager

用在一对多或者多对多关系中的管理器。存在于以下两种情况：

• ForeignKey外键关系的另一端：

from django.db import models

  class Reporter(models.Model):
      # ...
      pass

  class Article(models.Model):
      reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)

下文的方法对于上面示例中的reporter.article_set管理器是有效的。

• ManyToMany关系的两端：

class Topping(models.Model):
      # ...
      pass

class Pizza(models.Model):
    toppings = models.ManyToManyField(Topping)

下文的方法对于上面示例中的topping.pizza_set管理器和pizza.toppings管理器都是有效的。

​

add(*objs,bulk=True)

将指定模型对象加到相关对象集中。示例：

>>> b = Blog.objects.get(id=1)
>>> e = Entry.objects.get(id=234)
>>> b.entry_set.add(e) # Associates Entry e with Blog b.

在上面的示例中，外键关系的add()方法用QuerySet.update()来实施更新。这要求对象是已保存的。

当设置bulk=False时，则调用e.save()来实施更新。

当多对多关联对象使用add()方法时，并不调用save()方法，而是使用QuerySet.bulk_create()来创建关联。如果你在创建关联时需要执行一些自定义的逻辑，请查看m2m_changed 。

create(**kwargs)

创建一个新对象，保存并将它加入到关联对象集中。返回新创建的对象：

>>> b = Blog.objects.get(id=1)
>>> e = b.entry_set.create(
...     headline='Hello',
...     body_text='Hi',
...     pub_date=datetime.date(2005, 1, 1)
... )

# 这里不必调用 e.save() -- 它已经被保存了。

相当于：

>>> b = Blog.objects.get(id=1)
>>> e = Entry(
...     blog=b,
...     headline='Hello',
...     body_text='Hi',
...     pub_date=datetime.date(2005, 1, 1)
... )
>>> e.save(force_insert=True)

注意，不需要为关联模型指定关键字参数。在上面的示例中，没有传入blog参数到create()方法`中，因为Django已经知道新Entry对象的blog字段应设置为b。

remove(*objs)

将指定的模型对象从关联对象集中移除:

>>> b = Blog.objects.get(id=1)
>>> e = Entry.objects.get(id=234)
>>> b.entry_set.remove(e) # Disassociates Entry e from Blog b.

与add()类似，示例中调用了e.save()实施更新。而多对多关系使用remove()方法时，使用QuerySet.delete()删除关联。如果你在删除关联时需要执行一些自定义的逻辑，请查看m2m_changed 。

对于ForeignKey对象，只有null=True时本方法才有效。如果外键不允许为空，那么在关联到另一个模型前不能被删除。在上面的示例中，从b.entry_set()删除e相当于设置e.blog=None ，而由于blog的外键没有设置null=True,所以这是无效的。

对于外键对象，本方法接收bulk参数来控制怎么实施操作。如果为True （默认值），使用QuerySet.update() ；如果为False ，则每个单独的模型实例调用save()方法。这会触发pre_save和post_save信号，并会有性能开销。

clear()

移除关联对象集中的所有对象：

>>> b = Blog.objects.get(id=1)
>>> b.entry_set.clear()

注意，这并没有删除关联对象——只是消除了关联。

类似与remove() ，对于外键关系，只有null=True时，clear()才有效，它同样也接收bulk关键字参数。

set(objs, bulk=True, clear=False)

替换关联对象：

>>> new_list = [obj1, obj2, obj3]
>>> e.related_set.set(new_list)

本方法接收一个clear参数来控制操作方式。如果为False （默认值），先比较新旧对象集，在新对象集中没有的对象会用remove()从旧对象集中移除掉，然后只增加新旧对象不重叠的对象；如果为True ，则用clear()方法清楚所有旧对象集，然后一次性加入整个新对象集。

bulk参数会传入add()方法。

注意，由于set()是一个混合操作，它服从于竞争条件(race conditions)。例如，同时调用clear()和add()，但是结果可能是新对象被添加到数据库中。

译者注：竞争条件

竞争条件指多个线程或者进程在读写一个共享数据时结果依赖于它们执行的相对时间的情形。

竞争条件发生在当多个进程或者线程在读写数据时，其最终的的结果依赖于多个进程的指令执行顺序。

例如：考虑下面的例子

假设两个进程P1和P2共享了变量a。在某一执行时刻，P1更新a为1，在另一时刻，P2更新a为2。

因此两个任务竞争地写变量a。在这个例子中，竞争的“失败者”(最后更新的进程）决定了变量a的最终值。

多个进程并发访问和操作同一数据且执行结果与访问的特定顺序有关，称为竞争条件。

注意

对所有种类的关联字段，add() ，create() ，remove() ，clear() ，和set()都会立即应用更改，不必在任何一端再调用save() 。

另外，如果使用的是多对多关系的媒介模型，add() ，create() ，remove() 和set()方法是无效的。

如果使用prefetch_related() ，add() ，remove() ，clear() ，和set()会清除吊缓存。

直接赋值

通过将一个新的可迭代对象赋值给关联对象集，可以批量替换掉旧的对象集：

>>> new_list = [obj1, obj2, obj3]
>>> e.related_set = new_list

如果外键关系设置了null=True ，那么再添加新列表之前，关联管理器将首先解除原有对象集中对象的关联。否则的话，新的列表将加入到原有的对象集。

以下1.10版中的用法已废弃:

>>> e.related_set.set([obj1, obj2, obj3])