編寫(xiě)一個(gè)簡(jiǎn)單的表單?

讓我們更新一下在上一個(gè)教程中編寫(xiě)的投票詳細頁(yè)面的模板 ("polls/detail.html") ，讓它包含一個(gè) HTML <form> 元素：

<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>

簡(jiǎn)要說(shuō)明：

• 上面的模板在 Question 的每個(gè) Choice 前添加一個(gè)單選按鈕。 每個(gè)單選按鈕的 value 屬性是對應的各個(gè) Choice 的 ID。每個(gè)單選按鈕的 name 是 "choice" 。這意味著(zhù)，當有人選擇一個(gè)單選按鈕并提交表單提交時(shí)，它將發(fā)送一個(gè) POST 數據 choice=# ，其中# 為選擇的 Choice 的 ID。這是 HTML 表單的基本概念。

• 我們設置表單的 action 為 {% url 'polls:vote' question.id %} ，并設置 method="post" 。使用 method="post"``（與其相對的是 ``method="get"`）是非常重要的，因為這個(gè)提交表單的行為會(huì )改變服務(wù)器端的數據。 無(wú)論何時(shí)，當你需要創(chuàng )建一個(gè)改變服務(wù)器端數據的表單時(shí)，請使用 ``method="post" 。這不是 Django 的特定技巧；這是優(yōu)秀的網(wǎng)站開(kāi)發(fā)技巧。

• forloop.counter 指示 for 標簽已經(jīng)循環(huán)多少次。

• 由于我們創(chuàng )建一個(gè) POST 表單（它具有修改數據的作用），所以我們需要小心跨站點(diǎn)請求偽造。 謝天謝地，你不必太過(guò)擔心，因為 Django 已經(jīng)擁有一個(gè)用來(lái)防御它的非常容易使用的系統。 簡(jiǎn)而言之，所有針對內部 URL 的 POST 表單都應該使用 {% csrf_token %} 模板標簽。

現在，讓我們來(lái)創(chuàng )建一個(gè) Django 視圖來(lái)處理提交的數據。記住，在 教程第 3 部分 中，我們?yōu)橥镀睉脛?chuàng )建了一個(gè) URLconf ，包含這一行：

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

我們還創(chuàng )建了一個(gè) vote() 函數的虛擬實(shí)現。讓我們來(lái)創(chuàng )建一個(gè)真實(shí)的版本。 將下面的代碼添加到 polls/views.py ：

from django.http import HttpResponse, HttpResponseRedirectfrom django.shortcuts import get_object_or_404, renderfrom django.urls import reversefrom .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,)))

以上代碼中有些內容還未在本教程中提到過(guò)：

• request.POST 是一個(gè)類(lèi)字典對象，讓你可以通過(guò)關(guān)鍵字的名字獲取提交的數據。 這個(gè)例子中， request.POST['choice'] 以字符串形式返回選擇的 Choice 的 ID。 request.POST 的值永遠是字符串。

  注意，Django 還以同樣的方式提供 request.GET 用于訪(fǎng)問(wèn) GET 數據 —— 但我們在代碼中顯式地使用 request.POST ，以保證數據只能通過(guò) POST 調用改動(dòng)。

• 如果在 request.POST['choice'] 數據中沒(méi)有提供 choice ， POST 將引發(fā)一個(gè) KeyError 。上面的代碼檢查 KeyError ，如果沒(méi)有給出 choice 將重新顯示 Question 表單和一個(gè)錯誤信息。

• 在增加 Choice 的得票數之后，代碼返回一個(gè) HttpResponseRedirect 而不是常用的 HttpResponse 、 HttpResponseRedirect 只接收一個(gè)參數：用戶(hù)將要被重定向的 URL（請繼續看下去，我們將會(huì )解釋如何構造這個(gè)例子中的 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 just good Webdevelopment practice.

• 在這個(gè)例子中，我們在 HttpResponseRedirect 的構造函數中使用 reverse() 函數。這個(gè)函數避免了我們在視圖函數中硬編碼 URL。它需要我們給出我們想要跳轉的視圖的名字和該視圖所對應的 URL 模式中需要給該視圖提供的參數。 在本例中，使用在 教程第 3 部分 中設定的 URLconf， reverse() 調用將返回一個(gè)這樣的字符串：

  '/polls/3/results/'

  其中 3 是 question.id 的值。重定向的 URL 將調用 'results' 視圖來(lái)顯示最終的頁(yè)面。

正如在 教程第 3 部分 中提到的，HttpRequest 是一個(gè) HttpRequest 對象。更多關(guān)于 HttpRequest 對象的內容，請參見(jiàn) 請求和響應的文檔 。

當有人對 Question 進(jìn)行投票后， vote() 視圖將請求重定向到 Question 的結果界面。讓我們來(lái)編寫(xiě)這個(gè)視圖：

from django.shortcuts import get_object_or_404, renderdef results(request, question_id):    question = get_object_or_404(Question, pk=question_id)    return render(request, 'polls/results.html', {'question': question})

這和 教程第 3 部分 中的 detail() 視圖幾乎一模一樣。唯一的不同是模板的名字。 我們將在稍后解決這個(gè)冗余問(wèn)題。

現在，創(chuàng )建一個(gè) 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>

現在，在你的瀏覽器中訪(fǎng)問(wèn) /polls/1/ 然后為 Question 投票。你應該看到一個(gè)投票結果頁(yè)面，并且在你每次投票之后都會(huì )更新。 如果你提交時(shí)沒(méi)有選擇任何 Choice，你應該看到錯誤信息。

使用通用視圖：代碼還是少點(diǎn)好?

detail() （在 教程第3部分 中）和 results() 視圖都很簡(jiǎn)單 —— 并且，像上面提到的那樣，存在冗余問(wèn)題。用來(lái)顯示一個(gè)投票列表的 index() 視圖（也在 教程第 3 部分 中）和它們類(lèi)似。

這些視圖反映基本的 Web 開(kāi)發(fā)中的一個(gè)常見(jiàn)情況：根據 URL 中的參數從數據庫中獲取數據、載入模板文件然后返回渲染后的模板。 由于這種情況特別常見(jiàn)，Django 提供一種快捷方式，叫做“通用視圖”系統。

通用視圖將常見(jiàn)的模式抽象化，可以使你在編寫(xiě)應用時(shí)甚至不需要編寫(xiě)Python代碼。

讓我們將我們的投票應用轉換成使用通用視圖系統，這樣我們可以刪除許多我們的代碼。我們僅僅需要做以下幾步來(lái)完成轉換，我們將：

1. 轉換 URLconf。

2. 刪除一些舊的、不再需要的視圖。

3. 基于 Django 的通用視圖引入新的視圖。

請繼續閱讀來(lái)了解詳細信息。

from django.urls import pathfrom . import viewsapp_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 HttpResponseRedirectfrom django.shortcuts import get_object_or_404, renderfrom django.urls import reversefrom django.views import genericfrom .models import Choice, Questionclass 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.