[译]Django first steps Part4 1 写一个简单的form表单 2 使用generic views: 更少代码
我们继续polls应用
更新我们的“polls/detail.html”,增加一个form:修改polls/templates/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" />
<label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br />
{% endfor %}
<input type="submit" value="Vote" />
</form>
代码说明:
-
上面的template为每个问题的选择提供了一个radio button,每个radio button的内容和choice的id联系在一起,这就是说,有人选择了问题的答案,然后提交,它将会通过post的方法提交choice=#,#表示所选中的choice的id,这就是最基本的html form表单;
-
我们设置表单的动作是{% url 'polls:vote' question.id %},提交方法是post,这是十分重要的,因为这个动作将会把数据提交到服务器,这不是django特例,而是一个良好的web开发习惯;
-
forloop.counter表示for循环中的循环次数
-
一旦我们创建了一个post form表单,我们需要考虑跨站请求问题,在django中只需要使用一个temaplate tag就能解决此问题,即在form表单中增加{%csrf_token %}
现在我们来创建一个view来提交这个表单,还记得在part3里边的一条url记录吗?
url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),
我们也创建一个vote()的函数,增加到polls/views.py:
def vote(request,question_id):
question = get_object_or_404(models.Question,pk=question_id)
try:
selected_choice = question.choice_set.get(pk=request.POST["choice"])
except (KeyError,models.Choice.DoesNotExist):
return render(request,'polls/detail.html',{
'question':question,
'error_message':'You do not select a choice.',
})
else:
selected_choice.votes += 1
selected_choice.save()
return HttpResponseRedirect(reverse('polls:results',args=(question.id,)))
代码说明:
-
request.POST是一个类字典对象,可以通过key访问。在这个例子中,request.POST['choice'] 返回选择到的choice ID(以字符串的形式)。request.POST的值都是字符串,Djdango也提供request.GET用户获取数据。
-
request.POST['choice']如果没有取到数据,就会产生一个KeyError。并返回错误信息error_message。
-
自增vote数量,返回HttpResponseRedirect。HttpResponseRedirect有一个单独的参数:就是想要跳转的URL (see the following point for how we construct the URL in this case).This tip isn’t specific to Django; it’s just good Web development practice.
-
我们使用 reverse() 函数在 HttpResponseRedirect 参数中,这个函数能够避免view中的硬编码。它能够将url name转化为url字符串或正则表达式。在这个例子中,reverse() 返回字符串如下所示:
'/polls/3/results/'
修改views.py中的results函数:
def results(request,question_id):
question = get_object_or_404(models.Question,pk=question_id)
return render(request,"polls/results.html",{
"question":question
})
它和part3中的detail()很相似,只是template不一样而已;
修改polls/templates/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/ 来为问题投票,每次投完票就能看见结果页面。如果你们有选择直接提交,就会看到错误信息。
注意:
我们的vote() view还有个小问题,先从数据库得到selected_choice对象,然后计算数,然后返回数据库。如果有两个用户同时投票,就会出现问题。这叫竞赛,如果要解决这个问题,可以使用F()来解决此问题。
2 使用generic views: 更少代码
像前面提到的detail() 和results() views 非常简单,还有index()view,这些 views 是通常Web 开发模式:从数据库中得到数据,通过url加载模板并渲染模板。因为这种模式太寻常了,django又给大家提供了快捷方式:“generic views” 系统;
下面把我们的polls应用转变为generic views系统,我们需要删除一大推代码,分成下面几步:
-
转换URLconf
-
删除一些老的,没用的views
-
来一些Django’s generic views
为什么把代码搞来搞去?
通常的,当写一个Django app, 你需要先评估generic views 是否适合解决你的问题, 从开始就使用它们要比中间再改来的好。但在我们的例子中是为了让你了解核心思想,就像在你使用计算器之前你要先学会基本运算。
修改URLconf
打开polls/urls.py
并修改它:
from django.conf.urls import url
from . import views
app_name = 'polls'
urlpatterns = [
url(r'^$', views.IndexView.as_view(), name='index'),
url(r'^(?P<pk>[0-9]+)/$', views.DetailView.as_view(), name='detail'),
url(r'^(?P<pk>[0-9]+)/results/$', views.ResultsView.as_view(), name='results'),
url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),
]
我们注意到将原来的<question_id>
改成了 <pk>
。
修改views
删除原来老的index, detail, and results三个views,使用新的generic views来代替:
from django.shortcuts import get_object_or_404, render
from django.http import HttpResponseRedirect
from django.core.urlresolvers 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):
...
我们使用了两个generic views: ListView and DetailView. 分别表示 “display a list of objects” 和“display a detail page for a particular type of object.”。
-
每个generic view需要知道它所对应的models名称
-
DetailView从url中的pk参数获取主键值,所以我们已经在url中将question_id改成了pk了。
在默认情况下, DetailView generic view 将会使用一个叫做
相似的情况, the ListView generic view 使用默认模板文件
在上节中,我们的模板文件中有 question 和latest_question_list这种变量. 在DetailView 中 ,一旦我们使用django model,question 变量能够自动提供 Django会自动提供一个合适的环境变量名称。 然而, 对于ListView自动生成如question_list的变量名称。使用指定context_object_name变量,我们也能够自定义变量名称。我们可以在tempalte中将就django的自动产生变量,但是使用我们自己定义的变量更加容易。
运行服务器,就能看到基于generic views的应用了,要详细了解generic views自己看文档。当你熟悉了 forms and generic views后,可以参看part 5查看如何测试django应用。