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 允許擷取 Proxy 模型的 ContentType。

get_for_models(*models, for_concrete_models=True)[原始碼]¶

接受可變數量的模型類別，並傳回將模型類別對應至表示它們的 ContentType 執行個體的字典。for_concrete_models=False 允許擷取 Proxy 模型的 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://djangoproject.dev.org.tw/")
>>> 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。

class GenericTabularInline[原始碼]¶

class GenericStackedInline[原始碼]¶

分別具有堆疊式和表格式佈局的 GenericInlineModelAdmin 子類別。

GenericPrefetch()¶

class GenericPrefetch(lookup, querysets, to_attr=None)[原始碼]¶

此查詢方式與 Prefetch() 相似，且僅應使用於 GenericForeignKey。 querysets 參數接受一個查詢集列表，每個查詢集對應一個不同的 ContentType。這對於具有非同質結果集的 GenericForeignKey 非常有用。

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