ContentTypeManager¶

class ContentTypeManager[source]¶

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

clear_cache()[source]¶

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

get_for_id(id)[source]¶

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

get_for_model(model, for_concrete_model=True)[source]¶

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

get_for_models(*models, for_concrete_models=True)[source]¶

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

get_by_natural_key(app_label, model)[source]¶

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

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

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

反向泛型关系¶

class GenericRelation[source]¶

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://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[source]¶

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)[source]¶

使用 modelformset_factory() 返回一个 GenericInlineFormSet。

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

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

管理站点中的泛型关系¶

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

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

class GenericInlineModelAdmin[source]¶

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

ct_field¶

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

ct_fk_field¶

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

class GenericTabularInline[source]¶

class GenericStackedInline[source]¶

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

GenericPrefetch()¶

class GenericPrefetch(lookup, querysets, to_attr=None)[source]¶

此查找类似于 Prefetch()，并且只能用于 GenericForeignKey。 querysets 参数接受一个查询集列表，每个查询集对应一个不同的 ContentType。这对于结果集不均匀的 GenericForeignKey 很有用。

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