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

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

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

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

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

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

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

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

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

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