API встроенных представлений на основе классов

Спецификация

Каждый запрос, обрабатываемый представлением на основе класса, имеет независимое состояние; поэтому хранить переменные состояния в экземпляре безопасно (то есть self.foo = 3 является потокобезопасной операцией).

Представление на основе класса включается в шаблон URL с помощью метода класса as_view():

urlpatterns = [
    path("view/", MyView.as_view(size=42)),
]

Аргументы, переданные в as_view(), будут присвоены экземпляру, который используется для обработки запроса. В предыдущем примере это означает, что каждый запрос к MyView может использовать self.size. Аргументы должны соответствовать атрибутам, уже существующим в классе (в противном случае при проверке hasattr будет возвращено True).

Базовые и универсальные представления

Базовые представления на основе классов можно рассматривать как представления-родители, которые можно использовать самостоятельно или наследовать от них. Они могут не предоставлять все возможности, необходимые проектам; в таком случае можно воспользоваться примесями, расширяющими функциональность базовых представлений.

Универсальные представления Django построены на основе этих базовых представлений и разработаны как способ упростить распространенные сценарии использования, например отображение подробной информации об объекте. Они обобщают часто встречающиеся идиомы и шаблоны разработки представлений, позволяя быстро создавать стандартные представления данных без повторения кода.

Для большинства универсальных представлений требуется ключ queryset, представляющий собой экземпляр QuerySet; дополнительные сведения об объектах QuerySet см. в разделе Выполнение запросов.