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

В данном документе рассматриваются особенности класса 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

Каждый неабстрактный класс 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()

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

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.2/ref/models/class/