Référence de la classe Model¶
Ce document présente les fonctionnalités de la classe Model
. Pour plus d’informations à propos des modèles, consultez la liste complète des guides de référence des modèles.
Attributs¶
DoesNotExist
¶
- exception Model.DoesNotExist¶
Cette exception est produite par l’ORM lorsqu’un objet n’a pas été trouvé Par exemple,
QuerySet.get()
génère cette exception lorsqu’aucun objet ne correspond aux paramètres de requête indiqués.Django fournit une exception
DoesNotExist
comme attribut de chaque classe de modèle afin d’identifier la classe de l’objet qui n’a pas pu être trouvé, ce qui permet d’intercepter les exceptions spécifiques à une classe de modèle particulière. Cette exception est une sous-classe dedjango.core.exceptions.ObjectDoesNotExist
.
MultipleObjectsReturned
¶
- exception Model.MultipleObjectsReturned¶
Cette exception est produite par
QuerySet.get()
lorsque plusieurs objets correspondent aux paramètres de requête indiqués.Django fournit une exception
MultipleObjectsReturned
comme attribut de chaque classe de modèle afin d’identifier la classe d’objet pour laquelle plusieurs objets on été trouvés, ce qui permet d’intercepter les exceptions spécifiques à une classe de modèle particulière. Cette exception est une sous-classe dedjango.core.exceptions.MultipleObjectsReturned
.
objects
¶
- Model.objects¶
Chaque classe non abstraite
Model
doit recevoir une instance deManager
. Django s’assure que dans vos classes de modèles, chaque modèle dispose au moins d’un gestionnaireManager
par défaut. Si vous n’ajoutez pas vous-même un gestionnaire, Django ajoute un attributobjects
contenant une instance par défaut deManager
. Si vous ajoutez vous-même un attribut contenant une instance deManager
, l’instance par défaut n’est pas ajoutée. Considérez l’exemple suivant :from django.db import models class Person(models.Model): # Add manager with another name people = models.Manager()
Pour plus de détails sur les gestionnaires de modèles, consultez Gestionnaires et Sélection d’objets.