Справочник по классу модели

В этом документе описываются особенности класса Model. Для получения дополнительной информации о моделях см. полный список руководств по справочнику моделей.

Атрибуты

DoesNotExist

exception Model.DoesNotExist

Это исключение поднимается СУБД, когда ожидаемый объект не найден. Например, QuerySet.get() поднимет его, когда для заданных условий поиска не будет найдено ни одного объекта.

Django предоставляет исключение DoesNotExist в качестве атрибута каждого класса модели для идентификации класса объекта, который не был найден, позволяя ловить исключения для определенного класса модели. Исключение является подклассом django.core.exceptions.ObjectDoesNotExist.

MultipleObjectsReturned

exception Model.MultipleObjectsReturned

Это исключение поднимается QuerySet.get(), когда для заданных условий поиска находятся несколько объектов.

Django предоставляет исключение MultipleObjectsReturned в качестве атрибута каждого класса модели для идентификации класса объекта, для которого были найдены несколько объектов, что позволяет ловить исключения для определенного класса модели. Исключение является подклассом django.core.exceptions.MultipleObjectsReturned.

objects

Model.objects

Каждый не абстрактный класс Model должен иметь добавленный экземпляр Manager. Django гарантирует, что в вашем классе модели будет указан по крайней мере Manager. Если вы не добавите свой Manager, Django добавит атрибут objects, содержащий экземпляр Manager по умолчанию. Если вы добавите свой собственный атрибут Manager, экземпляр по умолчанию не появится. Рассмотрим следующий пример:

from django.db import models

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

Для получения дополнительной информации о менеджерах моделей см. Менеджеры и Получение объектов.