モデルクラスリファレンス—Djangoドキュメント

モデルクラスリファレンス

このドキュメントでは、 Model クラスの機能について説明します。 モデルの詳細については、モデルリファレンスガイドの完全なリストを参照してください。

属性

DoesNotExist

exception Model.DoesNotExist

この例外は、予期されたオブジェクトが見つからない場合にORMによって発生します。 たとえば、 QuerySet.get（）は、指定されたルックアップのオブジェクトが見つからない場合にそれを発生させます。

Djangoは、各モデルクラスの属性としてDoesNotExist例外を提供し、見つからなかったオブジェクトのクラスを識別して、特定のモデルクラスの例外をキャッチできるようにします。 例外は、 django.core.exceptions.ObjectDoesNotExist のサブクラスです。

MultipleObjectsReturned

exception Model.MultipleObjectsReturned

この例外は、特定のルックアップに対して複数のオブジェクトが見つかった場合に QuerySet.get（）によって発生します。

Djangoは、各モデルクラスの属性としてMultipleObjectsReturned例外を提供し、複数のオブジェクトが見つかったオブジェクトのクラスを識別して、特定のモデルクラスの例外をキャッチできるようにします。 例外は、 django.core.exceptions.MultipleObjectsReturned のサブクラスです。

objects

Model.objects

各非抽象モデルクラスには、 Manager インスタンスを追加する必要があります。 Djangoは、モデルクラスで少なくともデフォルトのManagerが指定されていることを確認します。 独自のManagerを追加しない場合、Djangoはデフォルトの Manager インスタンスを含む属性objectsを追加します。 独自の Manager インスタンス属性を追加すると、デフォルトの属性は表示されません。 次の例を考えてみましょう。

from django.db import models

class Person(models.Model):
    # Add manager with another name
    people = models.Manager()

モデルマネージャーの詳細については、マネージャーおよびオブジェクトの取得を参照してください。