我又回來了、這段時間、哎、、、不說了
這麼學習下去效率太低了
最近新註冊了公衆號、有興趣的可以關注一下、雖然感覺不太可能有人關注
歡迎關注倒懸山
----------------------------------------------------------------------------------------------------------------------------------------
一、表單form
我們之前的表單只是一個問題展示,所以我們需要做一個真正的用戶投票頁面,重寫先前的polls/detail.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>
簡要說明:
- 上面的模板顯示一系列單選按鈕,按鈕的值是選項的ID,按鈕的名字是字符串"choice"。這意味着,當你選擇了其中某個按鈕,並提交表單,一個包含數據
choice=#
的POST請求將被髮送到指定的url,#
是被選擇的選項的ID。這就是HTML表單的基本概念。 - 如果你有一定的前端開發基礎,那麼form標籤的action屬性和method屬性你應該很清楚它們的含義,action表示你要發送的目的url,method表示提交數據的方式,一般分post和get。
- forloop.counter是DJango模板系統專門提供的一個變量,用來表示你當前循環的次數,一般用來給循環項目添加有序數標。
- 由於我們發送了一個POST請求,就必須考慮一個跨站請求僞造的安全問題,簡稱CSRF(具體含義請百度)。Django爲你提供了一個簡單的方法來避免這個困擾,那就是在form表單內添加一條{% csrf_token %}標籤,標籤名不可更改,固定格式,位置任意,只要是在form表單內。這個方法對form表單的提交方式方便好使,但如果是用ajax的方式提交數據,那麼就不能用這個方法了。
現在,讓我們創建一個處理提交過來的數據的視圖。前面我們已經寫了一個vote視圖的url(polls/urls.py):
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):
return render(request, 'polls/detail.html', {
'question': question,
'error_message': "You didn't select a choice.",
})
else:
selected_choice.votes += 1
selected_choice.save()
return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))
有些新的東西,我們要解釋一下:
- request.POST是一個類似字典的對象,允許你通過鍵名訪問提交的數據。本例中,
request.POST['choice']
返回被選擇選項的ID,並且值的類型永遠是string字符串,那怕它看起來像數字!同樣的,你也可以用類似的手段獲取GET請求發送過來的數據,一個道理。 request.POST['choice']
有可能觸發一個KeyError異常,如果你的POST數據裏沒有提供choice鍵值,在這種情況下,上面的代碼會返回表單頁面並給出錯誤提示。- 在選擇計數器加一後,返回的是一個
HttpResponseRedirect
而不是先前我們常用的HttpResponse
。HttpResponseRedirect需要一個參數:重定向的URL。這裏有一個建議,當你成功處理POST數據後,應當保持一個良好的習慣,始終返回一個HttpResponseRedirect。這不僅僅是對Django而言,它是一個良好的WEB開發習慣。 - 我們在上面HttpResponseRedirect的構造器中使用了一個
reverse()
函數。它能幫助我們避免在視圖函數中硬編碼URL。它首先需要一個我們在URLconf中指定的name,然後是傳遞的數據。例如'/polls/3/results/'
,其中的3是某個question.id
的值。重定向後將進入polls:results
對應的視圖,並將question.id
傳遞給它。白話來講,就是把活扔給另外一個路由對應的視圖去幹。
當有人對某個問題投票後,vote()視圖重定向到了問卷的結果顯示頁面。下面我們來寫這個處理結果頁面的視圖(polls/views.py):
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})
同樣,還需要寫個模板polls/templates/polls/results.html
。(路由、視圖、模板、模型!都是這個套路....)
二、 使用通用視圖:減少重複代碼
上面的detail、index和results視圖的代碼非常相似,所以我們可以考慮是否可以將他們重寫以達到通用。
他們都是通過從URL傳遞過來的參數去數據庫查詢數據,加載一個模板,利用剛纔的數據渲染模板,返回這個模板。由於這個過程是如此的常見,Django很善解人意的幫你想辦法偷懶,於是它提供了一種快捷方式,名爲“通用視圖”。
整個過程分三步走:
- 修改URLconf設置
- 刪除一些舊的無用的視圖
- 採用基於類視圖的新視圖
1.改良URLconf
打開polls/urls.py
文件,將其修改成下面的樣子:
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'),
]
2.修改視圖
打開polls/views.py
文件,刪掉index、detail和results視圖,替換成Django的通用視圖,如下所示:
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):
... # 同前面的一樣,不需要修改
在這裏,我們使用了兩種通用視圖ListView
和DetailView
(它們是作爲父類被繼承的)。這兩者分別代表“顯示一個對象的列表”和“顯示特定類型對象的詳細頁面”的抽象概念。
-
每一種通用視圖都需要知道它要作用在哪個模型上,這通過model屬性提供。
-
DetailView
需要從url捕獲到的稱爲"pk"的主鍵值,因此我們在url文件中將2和3條目的<question_id>
修改成了<pk>
。
默認情況下,DetailView
通用視圖使用一個稱作<app name>/<model name>_detail.html
的模板。在本例中,實際使用的是polls/detail.html
。template_name
屬性就是用來指定這個模板名的,用於代替自動生成的默認模板名。(一定要仔細觀察上面的代碼,對號入座,注意細節。)同樣的,在resutls列表視圖中,指定template_name
爲'polls/results.html'
,這樣就確保了雖然resulst視圖和detail視圖同樣繼承了DetailView類,使用了同樣的model:Qeustion,但它們依然會顯示不同的頁面。(模板不同嘛!so easy!)
類似的,ListView通用視圖使用一個默認模板稱爲<app name>/<model name>_list.html
。我們也使用template_name
這個變量來告訴ListView使用我們已經存在的 "polls/index.html"
模板,而不是使用它自己默認的那個。
在教程的前面部分,我們給模板提供了一個包含question
和latest_question_list
的上下文變量。而對於DetailView,question變量會被自動提供,因爲我們使用了Django的模型(Question),Django會智能的選擇合適的上下文變量。然而,對於ListView,自動生成的上下文變量是question_list
。爲了覆蓋它,我們提供了context_object_name
屬性,指定說我們希望使用latest_question_list
而不是question_list
。