编写一个最简表单¶

让我们更新上一个教程中的投票详情模板（“polls/detail.html”），使其包含一个 HTML <form> 元素

<form action="{% url 'polls:vote' question.id %}" method="post">
{% csrf_token %}
<fieldset>
    <legend><h1>{{ question.question_text }}</h1></legend>
    {% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}
    {% 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 %}
</fieldset>
<input type="submit" value="Vote">
</form>

快速概览

• 上述模板为每个问题选项显示一个单选按钮。每个单选按钮的 value 是相关问题选项的 ID。每个单选按钮的 name 是 "choice"。这意味着，当有人选择其中一个单选按钮并提交表单时，它将发送 POST 数据 choice=#，其中 # 是所选选项的 ID。这是 HTML 表单的基本概念。

• 我们将表单的 action 设置为 {% url 'polls:vote' question.id %}，并将 method="post"。使用 method="post"（而不是 method="get"）非常重要，因为提交此表单的行为将更改服务器端的数据。每当你创建一个更改服务器端数据的表单时，请使用 method="post"。此提示并非特定于 Django；它通常是良好的 Web 开发实践。

• forloop.counter 指示 for 标签在其循环中执行了多少次

• 由于我们正在创建一个 POST 表单（它可能修改数据），因此我们需要担心跨站点请求伪造。值得庆幸的是，您不必过于担心，因为 Django 带有一个有助于防止它的系统。简而言之，所有针对内部 URL 的 POST 表单都应使用 {% csrf_token %} 模板标签。

现在，让我们创建一个处理提交的数据并对其进行处理的 Django 视图。请记住，在教程 3中，我们为 polls 应用程序创建了一个 URLconf，其中包含以下行

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

我们还创建了 vote() 函数的虚拟实现。让我们创建一个真实的版本。将以下内容添加到 polls/views.py 中

from django.db.models import F
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 = F("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'] 返回所选选项的 ID（作为字符串）。request.POST 的值始终为字符串。

  请注意，Django 还提供 request.GET 以相同的方式访问 GET 数据，但我们在代码中明确使用 request.POST，以确保仅通过 POST 调用更改数据。

• request.POST['choice'] 如果 POST 数据中未提供 choice，则将引发 KeyError。上述代码检查 KeyError，如果未给出 choice，则重新显示问题表单并显示错误消息。

• F("votes") + 1 指示数据库 将投票数增加 1。

• 递增选项计数后，代码返回 HttpResponseRedirect 而不是普通的 HttpResponse。HttpResponseRedirect 接受一个参数：用户将被重定向到的 URL（有关在本例中如何构造 URL，请参见下一段）。

  如上面的 Python 注释所指出的，在成功处理 POST 数据后，您应该始终返回 HttpResponseRedirect。此提示并非特定于 Django；它通常是良好的 Web 开发实践。

• 我们在此示例中使用了 reverse() 函数在 HttpResponseRedirect 构造函数中。此函数有助于避免在视图函数中硬编码 URL。它给出了我们想要将控制权传递到的视图的名称以及指向该视图的 URL 模式的可变部分。在本例中，使用我们在教程 3中设置的 URLconf，此 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})

这几乎与教程 3中的 detail() 视图完全相同。唯一的区别是模板名称。我们稍后将解决此冗余问题。

现在，创建一个 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/ 并对问题进行投票。您应该会看到一个结果页面，该页面在每次投票时都会更新。如果您在未选择选项的情况下提交表单，则应该会看到错误消息。

使用通用视图：更少的代码更好¶

从教程 3开始的 detail() 和 results() 视图非常简短，并且如上所述，是冗余的。index() 视图（显示投票列表）与此类似。

这些视图代表了基础 Web 开发中的一个常见案例：根据 URL 中传递的参数从数据库获取数据，加载模板并返回渲染后的模板。由于这种情况非常普遍，Django 提供了一个快捷方式，称为“通用视图”系统。

通用视图将常见模式抽象化到无需编写 Python 代码即可编写应用程序的程度。例如，ListView 和 DetailView 通用视图分别抽象了“显示对象列表”和“显示特定类型对象的详细信息页面”的概念。

让我们将我们的投票应用转换为使用通用视图系统，这样我们就可以删除很多我们自己的代码。我们将需要采取一些步骤来进行转换。我们将

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.db.models import F
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.
    ...