Написание вашего первого приложения Django, часть 4 ¶

Напишите минимальную форму ¶

Давайте обновим наш шаблон деталей опроса («polls / detail.html») из последнего руководства, чтобы он содержал <form> элемент HTML :

<h1>{{ question.question_text }}</h1>

{% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}

<form action="{% url 'polls:vote' question.id %}" method="post">
{% csrf_token %}
{% for choice in question.choice_set.all %}
    <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}">
    <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br>
{% endfor %}
<input type="submit" value="Vote">
</form>

Краткое изложение:

• В приведенном выше шаблоне для каждого варианта вопроса отображается переключатель. value Каждая кнопка радиосистемы ID Ассоциированный сомнение выбор в. У name каждой радиокнопки есть "choice" . Это означает, что когда кто-то выбирает один из переключателей и отправляет форму, он отправляет данные POST, choice=# где # - это идентификатор выбранного варианта. Это основная концепция HTML-форм.
• Мы ставим форму это action к , и мы . Использование (в отличие от ) очень важно, потому что акт отправки этой формы изменит данные на стороне сервера. Всякий раз, когда вы создаете форму, изменяющую данные на стороне сервера, используйте . Этот совет не относится к Django; это хорошая практика веб-разработки в целом.{% url 'polls:vote' question.id %} method="post" method="post" method="get" method="post"
• forloop.counter указывает, сколько раз for тег прошел свой цикл
• Поскольку мы создаем форму POST (которая может влиять на изменение данных), нам нужно беспокоиться о подделках межсайтовых запросов. К счастью, вам не нужно слишком сильно беспокоиться, потому что Django поставляется с полезной системой для защиты от этого. Короче говоря, все формы POST, нацеленные на внутренние URL-адреса, должны использовать тег шаблона.{% csrf_token %}

Теперь давайте создадим представление Django, которое обрабатывает отправленные данные и что-то с ними делает. Помните, что в Уроке 3 мы создали URLconf для приложения опросов, который включает эту строку:

path('<int:question_id>/vote/', views.vote, name='vote'),

Мы также создали фиктивную реализацию vote() функции. Создадим реальную версию. Добавьте следующее в polls/views.py :

from django.http import HttpResponse, HttpResponseRedirect
from django.shortcuts import get_object_or_404, render
from django.urls import reverse

from .models import Choice, Question
# ...
def vote(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    try:
        selected_choice = question.choice_set.get(pk=request.POST['choice'])
    except (KeyError, Choice.DoesNotExist):
        # Redisplay the question voting form.
        return render(request, 'polls/detail.html', {
            'question': question,
            'error_message': "You didn't select a choice.",
        })
    else:
        selected_choice.votes += 1
        selected_choice.save()
        # Always return an HttpResponseRedirect after successfully dealing
        # with POST data. This prevents data from being posted twice if a
        # user hits the Back button.
        return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))

Этот код включает в себя несколько вещей, которые мы еще не рассмотрели в этом руководстве:

• request.POST - подобный словарю объект, который позволяет вам получать доступ к отправленным данным по имени ключа. В этом случае request.POST['choice'] возвращает идентификатор выбранного варианта в виде строки. request.POST значения всегда являются строками.

  Обратите внимание, что Django также обеспечивает request.GET доступ к данным GET таким же образом, но мы явно используем это request.POST в нашем коде, чтобы гарантировать, что данные изменяются только через вызов POST.

• request.POST['choice'] будет повышаться, KeyError если choice не было указано в данных POST. Приведенный выше код проверяет KeyError и повторно отображает форму вопроса с сообщением об ошибке, если choice оно не указано.

• После увеличения счетчика вариантов код возвращает значение, HttpResponseRedirect а не нормальное HttpResponse . HttpResponseRedirect принимает единственный аргумент: URL-адрес, на который будет перенаправлен пользователь (см. следующий пункт о том, как мы создаем URL-адрес в этом случае).

  Как указано в комментарии Python выше, вы всегда должны возвращать HttpResponseRedirect после успешной обработки данных POST. Этот совет не относится к Django; это хорошая практика веб-разработки в целом.

• В этом примере мы используем reverse() функцию в HttpResponseRedirect конструкторе. Эта функция помогает избежать жесткого кодирования URL-адреса в функции просмотра. Ему дается имя представления, которому мы хотим передать управление, и переменная часть шаблона URL, указывающая на это представление. В этом случае, используя URLconf, который мы установили в Уроке 3 , этот reverse() вызов вернет строку вида

  '/polls/3/results/'
  

  где 3 - значение question.id . Этот перенаправленный URL-адрес затем вызовет 'results' представление для отображения последней страницы.

Как упоминалось в Уроке 3 , request это HttpRequest объект. Подробнее об HttpRequest объектах см. В документации по запросам и ответам .

После того, как кто-то голосует за вопрос, vote() представление перенаправляется на страницу результатов для этого вопроса. Напишем это представление:

from django.shortcuts import get_object_or_404, render


def results(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, 'polls/results.html', {'question': question})

Это почти то же самое, что и detail() вид из Урока 3 . Единственное отличие - это название шаблона. Мы исправим эту избыточность позже.

Теперь создайте polls/results.html шаблон:

<h1>{{ question.question_text }}</h1>

<ul>
{% for choice in question.choice_set.all %}
    <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>
{% endfor %}
</ul>

<a href="{% url 'polls:detail' question.id %}">Vote again?</a>

Теперь зайдите /polls/1/ в свой браузер и проголосуйте за вопрос. Вы должны увидеть страницу результатов, которая обновляется каждый раз, когда вы голосуете. Если вы отправите форму, не выбрав вариант, вы должны увидеть сообщение об ошибке.

Используйте общие представления: меньше кода - лучше ¶

Виды detail() (из Урока 3 ) и results() очень короткие и, как упоминалось выше, избыточны. Представление index() , в котором отображается список опросов, аналогично.

Эти представления представляют собой общий случай базовой веб-разработки: получение данных из базы данных в соответствии с параметром, переданным в URL-адресе, загрузка шаблона и возврат обработанного шаблона. Поскольку это очень распространено, Django предоставляет ярлык, называемый системой «общих представлений».

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

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

1. Преобразуйте URLconf.
2. Удалите некоторые старые ненужные представления.
3. Представьте новые представления, основанные на общих представлениях Django.

Читайте подробности.

from django.urls import path

from . import views

app_name = 'polls'
urlpatterns = [
    path('', views.IndexView.as_view(), name='index'),
    path('<int:pk>/', views.DetailView.as_view(), name='detail'),
    path('<int:pk>/results/', views.ResultsView.as_view(), name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

from django.http import HttpResponseRedirect
from django.shortcuts import get_object_or_404, render
from django.urls import reverse
from django.views import generic

from .models import Choice, Question


class IndexView(generic.ListView):
    template_name = 'polls/index.html'
    context_object_name = 'latest_question_list'

    def get_queryset(self):
        """Return the last five published questions."""
        return Question.objects.order_by('-pub_date')[:5]


class DetailView(generic.DetailView):
    model = Question
    template_name = 'polls/detail.html'


class ResultsView(generic.DetailView):
    model = Question
    template_name = 'polls/results.html'


def vote(request, question_id):
    ... # same as above, no changes needed.