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.
DoesNotExistLien vers cette rubrique#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 de django.core.exceptions.ObjectDoesNotExist.
MultipleObjectsReturnedLien vers cette rubrique#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 de django.core.exceptions.MultipleObjectsReturned.
NotUpdatedLien vers cette rubrique#Cette exception est générée lorsqu’une mise à jour forcée d’une instance de Model n’affecte aucun champ dans la base de données.
Django fournit une exception NotUpdated comme attribut de chaque classe de modèle afin d’identifier la classe de l’objet qui n’a pas pu être modifié, ce qui permet d’intercepter les exceptions spécifiques à une classe de modèle particulière. Cette exception est une sous-classe de django.core.exceptions.ObjectNotUpdated et hérite de django.db.DatabaseError pour des raisons de rétrocompatibilité.
objectsLien vers cette rubrique#Chaque classe non abstraite Model doit recevoir une instance de Manager. Django s’assure que dans vos classes de modèles, chaque modèle dispose au moins d’un gestionnaire Manager par défaut. Si vous n’ajoutez pas vous-même un gestionnaire, Django ajoute un attribut objects contenant une instance par défaut de Manager. Si vous ajoutez vous-même un attribut contenant une instance de Manager, l’instance par défaut n’est pas ajoutée. Considérez l’exemple suivant :
from django.db import models\n\n\nclass Person(models.Model):\n # Add manager with another name\n people = models.Manager()\nPour plus de détails sur les gestionnaires de modèles, consultez Gestionnaires et Sélection d’objets.
\n