从哪里获得帮助：

如果你在阅读本教程的过程中有任何疑问，可以前往 FAQ 的获取帮助 的版块。

编写一个简单的表单¶

让我们更新一下在上一个教程中编写的投票详细页面的模板 ("polls/detail.html") ，让它包含一个 HTML<form> 元素：

<h1>{{question.question_text}}</h1>{%iferror_message%}<p><strong>{{error_message}}</strong></p>{%endif%}<formaction="{%url'polls:vote'question.id%}"method="post">{%csrf_token%}{%forchoiceinquestion.choice_set.all%}<inputtype="radio"name="choice"id="choice{{forloop.counter}}"value="{{choice.id}}"><labelfor="choice{{forloop.counter}}">{{choice.choice_text}}</label><br>{%endfor%}<inputtype="submit"value="Vote"></form>

简要说明：

• 上面的模板在 Question 的每个 Choice 前添加一个单选按钮。 每个单选按钮的value 属性是对应的各个 Choice 的 ID。每个单选按钮的name 是"choice" 。这意味着，当有人选择一个单选按钮并提交表单提交时，它将发送一个 POST 数据choice=# ，其中# 为选择的 Choice 的 ID。这是 HTML 表单的基本概念。
• 我们设置表单的action 为{%url'polls:vote'question.id%} ，并设置method="post" 。使用method="post" （与其相对的是method="get"`）是非常重要的，因为这个提交表单的行为会改变服务器端的数据。无论何时，当你需要创建一个改变服务器端数据的表单时，请使用``method="post" 。这不是 Django 的特定技巧；这是优秀的网站开发技巧。
• forloop.counter 指示for 标签已经循环多少次。
• 由于我们创建一个 POST 表单（它具有修改数据的作用），所以我们需要小心跨站点请求伪造。 谢天谢地，你不必太过担心，因为 Django 自带了一个非常有用的防御系统。 简而言之，所有针对内部 URL 的 POST 表单都应该使用{%csrf_token%} 模板标签。

现在，让我们来创建一个 Django 视图来处理提交的数据。记住，在教程第 3 部分 中，我们为投票应用创建了一个 URLconf ，包含这一行：

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

我们还创建了一个vote() 函数的虚拟实现。让我们来创建一个真实的版本。 将下面的代码添加到polls/views.py ：

fromdjango.httpimportHttpResponse,HttpResponseRedirectfromdjango.shortcutsimportget_object_or_404,renderfromdjango.urlsimportreversefrom.modelsimportChoice,Question# ...defvote(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.returnrender(request,'polls/detail.html',{'question':question,'error_message':"You didn't select a choice.",})else:selected_choice.votes+=1selected_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.returnHttpResponseRedirect(reverse('polls:results',args=(question.id,)))

以上代码中有些内容还未在本教程中提到过：

• request.POST 是一个类字典对象，让你可以通过关键字的名字获取提交的数据。 这个例子中，request.POST['choice'] 以字符串形式返回选择的 Choice 的 ID。request.POST 的值永远是字符串。

  注意，Django 还以同样的方式提供request.GET 用于访问 GET 数据 —— 但我们在代码中显式地使用request.POST ，以保证数据只能通过 POST 调用改动。

• 如果在request.POST['choice'] 数据中没有提供choice ， POST 将引发一个KeyError 。上面的代码检查KeyError ，如果没有给出choice 将重新显示 Question 表单和一个错误信息。

• 在增加 Choice 的得票数之后，代码返回一个HttpResponseRedirect 而不是常用的HttpResponse 、HttpResponseRedirect 只接收一个参数：用户将要被重定向的 URL（请继续看下去，我们将会解释如何构造这个例子中的 URL）。

  As the Python comment above points out, you should always return anHttpResponseRedirect after successfully dealing withPOST data. This tip isn't specific to Django; it's good Web developmentpractice in general.

• 在这个例子中，我们在HttpResponseRedirect 的构造函数中使用reverse() 函数。这个函数避免了我们在视图函数中硬编码 URL。它需要我们给出我们想要跳转的视图的名字和该视图所对应的 URL 模式中需要给该视图提供的参数。 在本例中，使用在教程第 3 部分 中设定的 URLconf，reverse() 调用将返回一个这样的字符串：

  '/polls/3/results/'

  其中3 是question.id 的值。重定向的 URL 将调用'results' 视图来显示最终的页面。

正如在教程第 3 部分 中提到的，HttpRequest 是一个HttpRequest 对象。更多关于HttpRequest 对象的内容，请参见请求和响应的文档 。

当有人对 Question 进行投票后，vote() 视图将请求重定向到 Question 的结果界面。让我们来编写这个视图：

fromdjango.shortcutsimportget_object_or_404,renderdefresults(request,question_id):question=get_object_or_404(Question,pk=question_id)returnrender(request,'polls/results.html',{'question':question})

这和教程第 3 部分 中的detail() 视图几乎一模一样。唯一的不同是模板的名字。 我们将在稍后解决这个冗余问题。

现在，创建一个polls/results.html 模板：

<h1>{{question.question_text}}</h1><ul>{%forchoiceinquestion.choice_set.all%}<li>{{choice.choice_text}} --{{choice.votes}} vote{{choice.votes|pluralize}}</li>{%endfor%}</ul><ahref="{%url'polls:detail'question.id%}">Vote again?</a>

现在，在你的浏览器中访问/polls/1/ 然后为 Question 投票。你应该看到一个投票结果页面，并且在你每次投票之后都会更新。 如果你提交时没有选择任何 Choice，你应该看到错误信息。

使用通用视图：代码还是少点好¶

detail() （在教程第 3 部分 中）和results() 视图都很精简 —— 并且，像上面提到的那样，存在冗余问题。用来显示一个投票列表的index() 视图（也在教程第 3 部分 中）和它们类似。

这些视图反映基本的 Web 开发中的一个常见情况：根据 URL 中的参数从数据库中获取数据、载入模板文件然后返回渲染后的模板。 由于这种情况特别常见，Django 提供一种快捷方式，叫做“通用视图”系统。

通用视图将常见的模式抽象化，可以使你在编写应用时甚至不需要编写Python代码。

让我们将我们的投票应用转换成使用通用视图系统，这样我们可以删除许多我们的代码。我们仅仅需要做以下几步来完成转换，我们将：

1. 转换 URLconf。
2. 删除一些旧的、不再需要的视图。
3. 基于 Django 的通用视图引入新的视图。

请继续阅读来了解详细信息。

fromdjango.urlsimportpathfrom.importviewsapp_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'),]

fromdjango.httpimportHttpResponseRedirectfromdjango.shortcutsimportget_object_or_404,renderfromdjango.urlsimportreversefromdjango.viewsimportgenericfrom.modelsimportChoice,QuestionclassIndexView(generic.ListView):template_name='polls/index.html'context_object_name='latest_question_list'defget_queryset(self):"""Return the last five published questions."""returnQuestion.objects.order_by('-pub_date')[:5]classDetailView(generic.DetailView):model=Questiontemplate_name='polls/detail.html'classResultsView(generic.DetailView):model=Questiontemplate_name='polls/results.html'defvote(request,question_id):...# same as above, no changes needed.