Создание представлений

Функция представления, или представление вкратце, — это просто функция Python, которая принимает веб-запрос и возвращает веб-ответ. Этот ответ может быть HTML-содержимым веб-страницы, перенаправлением, ошибкой 404, XML-документом, изображением… или чем угодно. Само представление содержит необходимую произвольную логику для возврата этого ответа. Этот код может находиться в любом месте, при условии, что он находится на пути Python. Других требований нет — нет никакой «магии», так сказать. Для того, чтобы разместить код где-то, принято размещать представления в файле, названном views.py, в каталоге вашего проекта или приложения.

Простое представление

Вот представление, которое возвращает текущую дату и время в виде HTML-документа:

from django.http import HttpResponse
import datetime

def current_datetime(request):
    now = datetime.datetime.now()
    html = "<html><body>It is now %s.</body></html>" % now
    return HttpResponse(html)

Давайте пройдёмся по этому коду строка за строкой:

Сначала мы импортируем класс HttpResponse из модуля django.http, а также библиотеку Python datetime.
Далее мы определяем функцию, названную current_datetime. Это функция представления. Каждая функция представления принимает объект HttpRequest в качестве своего первого параметра, который обычно называется request.

Обратите внимание, что имя функции представления не имеет значения; Django не требует от него определённой структуры. Мы называем её current_datetime здесь, потому что это имя чётко указывает, что она делает.
Представление возвращает объект HttpResponse, содержащий сгенерированный ответ. Каждая функция представления отвечает за возврат объекта HttpResponse. (Есть исключения, но мы рассмотрим их позже.)

Временная зона Django

Django включает в себя настройку TIME_ZONE, которая по умолчанию установлена в America/Chicago. Вероятно, она не соответствует вашему часовому поясу, поэтому вам следует изменить её в файле настроек.

Сопоставление URL-адресов с представлениями

Итак, резюмируя, эта функция представления возвращает HTML-страницу, содержащую текущую дату и время. Чтобы отобразить это представление по определённому URL-адресу, вам необходимо создать URLconf; см. Диспечер URL для получения инструкций.

Возврат ошибок

Возвращение кодов ошибок HTTP в Django просто. Существуют подклассы HttpResponse для ряда распространённых кодов статуса HTTP, отличных от 200 (что означает «ОК»). Полный список доступных подклассов можно найти в документации запрос/ответ. Просто верните экземпляр одного из этих подклассов вместо обычного объекта HttpResponse, чтобы указать ошибку. Например:

from django.http import HttpResponse, HttpResponseNotFound

def my_view(request):
    # ...
    if foo:
        return HttpResponseNotFound('<h1>Page not found</h1>')
    else:
        return HttpResponse('<h1>Page was found</h1>')

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

from django.http import HttpResponse

def my_view(request):
    # ...

    # Return a "created" (201) response code.
    return HttpResponse(status=201)

Поскольку ошибки 404 — самые распространённые ошибки HTTP, есть более простой способ их обработки.

Исключение Http404

class django.http.Http404

Когда вы возвращаете ошибку, такую как HttpResponseNotFound, вы отвечаете за определение HTML результирующей страницы ошибки:

return HttpResponseNotFound('<h1>Page not found</h1>')

Для удобства и потому, что полезно иметь согласованную страницу ошибки 404 на вашем сайте, Django предоставляет исключение Http404. Если вы поднимите Http404 в любой момент в функции представления, Django перехватит его и вернёт стандартную страницу ошибки вашего приложения вместе с кодом ошибки HTTP 404.

Пример использования:

from django.http import Http404
from django.shortcuts import render_to_response
from polls.models import Poll

def detail(request, poll_id):
    try:
        p = Poll.objects.get(pk=poll_id)
    except Poll.DoesNotExist:
        raise Http404("Poll does not exist")
    return render_to_response('polls/detail.html', {'poll': p})

Для полноценного использования исключения Http404 вам следует создать шаблон, который отображается при возникновении ошибки 404. Этот шаблон должен называться 404.html и находиться в главном каталоге вашей иерархии шаблонов.

Если вы предоставляете сообщение при поднятии исключения Http404 , оно будет отображаться в стандартном шаблоне ошибки 404, когда DEBUG имеет значение True. Используйте эти сообщения для отладки; они обычно не подходят для использования в шаблоне ошибки 404 для производства.

Настройка представлений ошибок

По умолчанию представления ошибок Django должны подойти для большинства веб-приложений, но их можно легко переопределить, если вам требуется любое пользовательское поведение. Просто укажите обработчики, как показано ниже, в вашем URLconf (задание их в другом месте не повлияет).

Представление page_not_found() переопределяется handler404:

handler404 = 'mysite.views.my_custom_page_not_found_view'

Представление server_error() переопределяется handler500:

handler500 = 'mysite.views.my_custom_error_view'

Представление permission_denied() переопределяется handler403:

handler403 = 'mysite.views.my_custom_permission_denied_view'

Представление bad_request() переопределяется handler400:

handler400 = 'mysite.views.my_custom_bad_request_view'

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/1.8/topics/http/views/