ContentTypeManager¶

class ContentTypeManager¶

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

clear_cache()¶

清除 ContentType 用于跟踪已为其创建 ContentType 实例的模型的内部缓存。您可能永远不需要自己调用此方法；Django 会在需要时自动调用它。

get_for_id(id)¶

按 ID 查找 ContentType。由于此方法使用与 get_for_model() 相同的共享缓存，因此建议使用此方法，而不是通常的 ContentType.objects.get(pk=id)

get_for_model(model, for_concrete_model=True)¶

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

get_for_models(*models, for_concrete_models=True)¶

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

get_by_natural_key(app_label, model)¶

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

当您知道需要使用 ContentType 但又不想费力获取模型的元数据以执行手动查找时，get_for_model() 方法特别有用

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

反向泛型关系¶

class GenericRelation¶

related_query_name¶

默认情况下，关联对象与本对象的关联关系不存在。设置 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.django.ac.cn/")
>>> 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 []>

使用 related_query_name 设置定义 GenericRelation 允许从相关对象进行查询

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 接受内容类型和对象 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 信号提供备选行为。

泛型关系和聚合¶

Django 的数据库聚合 API 与 GenericRelation 协同工作。例如，你可以找出所有书签有多少个标签

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

表单中的泛型关系¶

django.contrib.contenttypes.forms 模块提供

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

class BaseGenericInlineFormSet¶

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)¶

使用 modelformset_factory() 返回 GenericInlineFormSet。

如果您提供的 ct_field 和 fk_field 与默认值不同，则必须提供 content_type 和 object_id。其他参数与 modelformset_factory() 和 inlineformset_factory() 中记录的参数类似。

for_concrete_model 参数对应于 GenericForeignKey 上的 for_concrete_model 参数。

管理中的泛型关系¶

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

这些类和函数支持在表单和管理中使用泛型关系。有关更多信息，请参阅 模型表单集 和 管理 文档。

class GenericInlineModelAdmin¶

类 GenericInlineModelAdmin 继承自类 InlineModelAdmin 的所有属性。但是，它添加了一些用于处理泛型关系的属性

ct_field¶

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

ct_fk_field¶

表示相关对象 ID 的整型字段的名称。默认为 object_id。

类 GenericTabularInline¶

类 GenericStackedInline¶

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

GenericPrefetch()¶

类 GenericPrefetch(lookup, querysets, to_attr=None)¶

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

>>> from django.contrib.contenttypes.prefetch import GenericPrefetch
>>> bookmark = Bookmark.objects.create(url="https://www.django.ac.cn/")
>>> 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>]>