Обязательные аргументы¶

request

Объект обрабатываемого запроса

template_name

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

Необязательные аргументы¶

context

Словарь переменных для контекста шаблона. По умолчанию, этот словарь пустой. Если значение ключа словаря это функция, она будет вызвана перед выполнением шаблона.

content_type

MIME-тип результата. По умолчанию используется значение настройки DEFAULT_CONTENT_TYPE.

status

Код HTTP статуса ответа. По умолчанию 200.

using

Параметр конфигурации NAME используется шаблонным движком для загрузки шаблона.

Примеры¶

Следующий пример выполняет шаблон myapp/index.html и возвращает ответ с MIME-типом application/xhtml+xml:

from django.shortcuts import render


def my_view(request):
    # View code here...
    return render(
        request,
        "myapp/index.html",
        {
            "foo": "bar",
        },
        content_type="application/xhtml+xml",
    )

Этот пример аналогичен:

from django.http import HttpResponse
from django.template import loader


def my_view(request):
    # View code here...
    t = loader.get_template("myapp/index.html")
    c = {"foo": "bar"}
    return HttpResponse(t.render(c, request), content_type="application/xhtml+xml")

Примеры¶

Функцию redirect() можно использовать несколькими способами.

1. Передавая объект; в качестве URL-а для перенаправления будет использоваться результат вызова метода get_absolute_url():

   from django.shortcuts import redirect
   
   
   def my_view(request):
       ...
       obj = MyModel.objects.get(...)
       return redirect(obj)
   

2. Передавая название представления и необходимые позиционные или именованные аргументы; URL будет вычислен с помощью функции reverse():

   def my_view(request):
       ...
       return redirect("some-view-name", foo="bar")
   

3. Передавая жестко запрограммированный URL-адрес для перенаправления на::

   def my_view(request):
       ...
       return redirect("/some/url/")
   

   Это также работает с полными URL-адресами:

   def my_view(request):
       ...
       return redirect("https://example.com/")
   

По умолчанию, redirect() возвращает временное перенаправление. Все варианты выше принимают аргумент permanent; если передать True будет использоваться постоянное перенаправление:

def my_view(request):
    ...
    obj = MyModel.objects.get(...)
    return redirect(obj, permanent=True)

Кроме того, аргумент preserve_request можно использовать для сохранения исходного метода HTTP:

def my_view(request):
    # ...
    obj = MyModel.objects.get(...)
    if request.method in ("POST", "PUT"):
        # Redirection preserves the original request method.
        return redirect(obj, preserve_request=True)
    # ...

Примеры¶

1. Разрешение URL-адреса модели, которая определяет get_absolute_url():

   models.py¶

   from django.db import models
   from django.urls import reverse
   
   
   class Article(models.Model):
       title = models.CharField(max_length=100)
   
       def get_absolute_url(self):
           return reverse("article-detail", args=[self.pk])
   

   views.py¶

   from django.http import JsonResponse
   from django.shortcuts import get_object_or_404, resolve_url
   from .models import Article
   
   
   def article_api_view(request, pk):
       """Return metadata about an article, including its canonical URL."""
       article = get_object_or_404(Article, pk=pk)
       return JsonResponse(
           {
               "id": article.pk,
               "title": article.title,
               "url": resolve_url(article),
           }
       )
   

2. Разрешение целевого URL-адреса для использования вне перенаправления, например, в заголовке ответа HTTP:

   from django.conf import settings
   from django.http import HttpResponse
   from django.shortcuts import resolve_url
   
   
   def login_success(request):
       response = HttpResponse("Login successful")
       response["X-Next-URL"] = resolve_url(settings.LOGIN_REDIRECT_URL)
       return response
   

Аргументы¶

klass

Класс Model, экземпляр Manager или QuerySet, который будет использован для получения объекта.

*args

Q объекты.

**kwargs

Параметры поиска в формате принимаемом методами get() и filter().

Примеры¶

Этот пример получает объект модели MyModel с первичным ключом равным 1:

from django.shortcuts import get_object_or_404


def my_view(request):
    obj = get_object_or_404(MyModel, pk=1)

Этот пример аналогичен:

from django.http import Http404


def my_view(request):
    try:
        obj = MyModel.objects.get(pk=1)
    except MyModel.DoesNotExist:
        raise Http404("No MyModel matches the given query.")

Обычно используется Model, как в примере выше. Но можно передать и объект QuerySet:

queryset = Book.objects.filter(title__startswith="M")
get_object_or_404(queryset, pk=1)

Приведенный пример немного надуманный, так как это равносильно:

get_object_or_404(Book, title__startswith="M", pk=1)

но может быть полезен, если queryset передается из другого места.

Также можно использовать Manager. Это полезно, если, например, вы используете собственный менеджер:

get_object_or_404(Book.dahl_objects, title="Matilda")

Можно использовать менеджер отношений между моделями:

author = Author.objects.get(name="Roald Dahl")
get_object_or_404(author.book_set, title="Matilda")

Заметим: так как используется метод get(), может быть вызвано исключение MultipleObjectsReturned, если запрос вернет несколько объектов.

Аргументы¶

klass

Экземпляр Model, Manager или QuerySet, который будет использован для получения списка объектов.

*args

Q объекты.

**kwargs

Параметры поиска в формате принимаемом методами get() и filter().

Примеры¶

Этот пример получает все опубликованные объекты модели``MyModel``:

from django.shortcuts import get_list_or_404


def my_view(request):
    my_objects = get_list_or_404(MyModel, published=True)

Этот пример аналогичен:

from django.http import Http404


def my_view(request):
    my_objects = list(MyModel.objects.filter(published=True))
    if not my_objects:
        raise Http404("No MyModel matches the given query.")