内容类型框架Link to this heading#

ContentTypeManagerLink to this heading#

class ContentTypeManagerLink to this definition#

ContentType 还有一个自定义管理器， ContentTypeManager，它增加了以下方法：

clear_cache()Link to this definition#

Clears an internal cache used by ContentType to keep track of models for which it has created ContentType instances. You probably won't need to call this method in application code yourself; Django will call it automatically when it's needed.

You may need to clear the cache when testing, to reset between tests, or after preparing test state. For example:

Code

class ContentTypesTests(TestCase):
    def setUp(self):
        ContentType.objects.clear_cache()
        self.addCleanup(ContentType.objects.clear_cache)

get_for_id(id)Link to this definition#

通过 ID 查找一个 ContentType。由于该方法与 get_for_model() 使用了相同的共享缓存，所以最好使用该方法，而不是通常的 ContentType.objects.get(pk=id)。

get_for_model(model, for_concrete_model=True)Link to this definition#

取一个模型类或一个模型的实例，并返回代表该模型的 ContentType 实例。for_concrete_model=False 允许获取代理模型的 ContentType 实例。

get_for_models(*models, for_concrete_models=True)Link to this definition#

取一个数量不等的模型类，并返回一个将模型类映射到代表它们的 ContentType 实例的字典。for_concrete_models=False 允许获取代理模型的 ContentType 实例。

get_by_natural_key(app_label, model)Link to this definition#

返回由给定的应用程序标签和模型名称唯一标识的 ContentType 实例。本方法的主要目的是允许 ContentType 对象在反序列化过程中通过 自然键 被引用。

The get_for_model() method is especially useful when you know you need to work with a ContentType but don't want to go to the trouble of obtaining the model's metadata to perform a manual lookup:

>>> from django.contrib.auth.models import User
>>> ContentType.objects.get_for_model(User)
<ContentType: user>

反查通用关系Link to this heading#

class GenericRelationLink to this definition#

related_query_nameLink to this definition#

默认情况下，相关对象与本对象的关系并不存在。设置 related_query_name 创建一个从相关对象到这个对象的关系。这样就可以从关联对象中进行查询和过滤。

如果你知道哪些模型你会最经常使用，你也可以添加一个 “反向” 的通用关系来启用一个额外的 API。例如：

from django.contrib.contenttypes.fields import GenericRelation
from django.db import models


class Bookmark(models.Model):
    url = models.URLField()
    tags = GenericRelation(TaggedItem)

每个 Bookmark 实例都将具有一个 tags 属性，可用于检索与它们关联的 TaggedItems：

>>> b = Bookmark(url="https://www.djangoproject.com/")
>>> b.save()
>>> t1 = TaggedItem(content_object=b, tag="django")
>>> t1.save()
>>> t2 = TaggedItem(content_object=b, tag="python")
>>> t2.save()
>>> b.tags.all()
<QuerySet [<TaggedItem: django>, <TaggedItem: python>]>

您还可以使用 add(), create() 或 set() 来创建关系：

>>> t3 = TaggedItem(tag="Web development")
>>> b.tags.add(t3, bulk=False)
>>> b.tags.create(tag="Web framework")
<TaggedItem: Web framework>
>>> b.tags.all()
<QuerySet [<TaggedItem: django>, <TaggedItem: python>, <TaggedItem: Web development>, <TaggedItem: Web framework>]>
>>> b.tags.set([t1, t3])
>>> b.tags.all()
<QuerySet [<TaggedItem: django>, <TaggedItem: Web development>]>

remove() 调用将批量删除指定的模型对象：

>>> b.tags.remove(t3)
>>> b.tags.all()
<QuerySet [<TaggedItem: django>]>
>>> TaggedItem.objects.all()
<QuerySet [<TaggedItem: django>]>

clear() 方法可以用于批量删除实例的所有相关对象：

>>> b.tags.clear()
>>> b.tags.all()
<QuerySet []>
>>> TaggedItem.objects.all()
<QuerySet []>

定义 GenericRelation，并设置 related_query_name 允许从相关对象查询：

tags = GenericRelation(TaggedItem, related_query_name="bookmark")

这使得可以从 TaggedItem 对 Bookmark 进行过滤、排序和其他查询操作：

>>> # Get all tags belonging to bookmarks containing `django` in the url
>>> TaggedItem.objects.filter(bookmark__url__contains="django")
<QuerySet [<TaggedItem: django>, <TaggedItem: python>]>

如果您不添加 related_query_name，您可以手动执行相同类型的查找操作：

>>> bookmarks = Bookmark.objects.filter(url__contains="django")
>>> bookmark_type = ContentType.objects.get_for_model(Bookmark)
>>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id__in=bookmarks)
<QuerySet [<TaggedItem: django>, <TaggedItem: python>]>

正如 GenericForeignKey 接受content-type 和 object-ID 字段的名称作为参数一样， GenericRelation 也是如此；如果拥有通用外键的模型对这些字段使用了非默认的名称，那么在给它设置 GenericRelation 时必须传递这些字段的名称。例如，如果上面提到的 TaggedItem 模型使用了名为 content_type_fk 和 object_primary_key 的字段来创建它的通用外键，那么回传给它的 GenericRelation 就需要这样定义：

tags = GenericRelation(
    TaggedItem,
    content_type_field="content_type_fk",
    object_id_field="object_primary_key",
)

还要注意的是，如果你删除了一个有 GenericRelation 的对象，任何有 GenericForeignKey 指向它的对象也会被删除。在上面的例子中，这意味着如果一个 Bookmark 对象被删除，任何指向它的 TaggedItem 对象也会同时被删除。

与 ForeignKey 不同， GenericForeignKey 不接受 on_delete 参数来定制这个行为；如果需要，可以不使用 GenericRelation 来避免级联删除，可以通过 pre_delete 信号来提供替代行为。

通用关系和聚合Link to this heading#

Django 的数据库聚合 API 可以与 GenericRelation 一起使用。例如，您可以找出所有书签有多少个标签：

>>> Bookmark.objects.aggregate(Count("tags"))
{'tags__count': 3}

表单中的通用关系Link to this heading#

django.contrib.contenttypes.forms 模块提供：

• BaseGenericInlineFormSet

• 一个表单集工厂， generic_inlineformset_factory()，用于 GenericForeignKey。

class BaseGenericInlineFormSetLink to this definition#

generic_inlineformset_factory(model, form=ModelForm, formset=BaseGenericInlineFormSet, ct_field='content_type', fk_field='object_id', fields=None, exclude=None, extra=3, can_order=False, can_delete=True, max_num=None, formfield_callback=None, validate_max=False, for_concrete_model=True, min_num=None, validate_min=False, absolute_max=None, can_delete_extra=True)Link to this definition#

使用 modelormset_factory() 返回一个 GenericInlineFormSet。

你必须提供 ct_field 和 fk_field，如果它们与默认值 content_type 和 object_id 不同。其他参数与 modelselformset_factory() 和 inlineformset_factory() 中记载的类似。

for_concrete_model 参数对应于 for_concrete_model` 参数。

管理中的通用关系Link to this heading#

django.contrib.contenttypes.admin 模块提供了 GenericTabularInline 和 GenericInlineModelAdmin 的子类）。

这些类和函数可以在表单和管理中使用通用关系。更多信息请参见 模型表单集 和 管理 文档。

class GenericInlineModelAdminLink to this definition#

GenericInlineModelAdmin 类继承了 InlineModelAdmin 类的所有属性。然而，它增加了一些自己的属性来处理通用关系：

ct_fieldLink to this definition#

模型上的 ContentType 外键字段的名称。默认为 content_type。

ct_fk_fieldLink to this definition#

代表相关对象 ID 的整数字段的名称。默认值为 object_id。

class GenericTabularInlineLink to this definition#

class GenericStackedInlineLink to this definition#

GenericInlineModelAdmin 的子类，分别具有堆栈式和表格式布局。

GenericPrefetch()Link to this heading#

class GenericPrefetch(lookup, querysets, to_attr=None)Link to this definition#

此查找类似于 Prefetch()，应仅用于 GenericForeignKey。querysets 参数接受一个查询集列表，每个查询集对应不同的 ContentType。这对于具有非同质结果集的 GenericForeignKey 非常有用。

>>> from django.contrib.contenttypes.prefetch import GenericPrefetch
>>> bookmark = Bookmark.objects.create(url="https://www.djangoproject.com/")
>>> animal = Animal.objects.create(name="lion", weight=100)
>>> TaggedItem.objects.create(tag="great", content_object=bookmark)
>>> TaggedItem.objects.create(tag="awesome", content_object=animal)
>>> prefetch = GenericPrefetch(
...     "content_object", [Bookmark.objects.all(), Animal.objects.only("name")]
... )
>>> TaggedItem.objects.prefetch_related(prefetch).all()
<QuerySet [<TaggedItem: Great>, <TaggedItem: Awesome>]>