视图是Django应用程序中的一种网页“类型”,通常提供特定的功能并具有特定的模板。在polls程序中,我们将创建4个视图。此文章衔接上一篇:Django Admin的使用
4个视图:
- index页面:显示最新问题
- detail页面:显示指定问题详情
- results页面:显示指定问题的投票结果
- 投票操作:处理对指定问题进行投票操作
在Django中,网页和其他内容是通过视图交付的。每个视图都由一个Python函数(或方法,在基于类的视图用例中)表示。Django将通过检查请求的URL(准确地说,是域名后面的URL部分)来选择一个视图。之前有提到过,django通过URLconfs来配置URL,并且以此匹配指定视图。
创建视图
在 polls/views.py里创建更多的视图,这些视图与之前的稍有不同,因为这里的视图函数带有参数。
def detail(request, question_id):
return HttpResponse("You're looking at question %s." % question_id)
def results(request, question_id):
response = "You're looking at the results of question %s."
return HttpResponse(response % question_id)
def vote(request, question_id):
return HttpResponse("You're voting on question %s." % question_id)
将新建的三个视图函数关联进polls的url内,使用path()函数。polls/urls.py修改如下:
from django.urls import path
from . import views
urlpatterns = [
# ex: /polls/
path('', views.index, name='index'),
# ex: /polls/5/
path('<int:question_id>/', views.detail, name='detail'),
# ex: /polls/5/results/
path('<int:question_id>/results/', views.results, name='results'),
# ex: /polls/5/vote/
path('<int:question_id>/vote/', views.vote, name='vote'),
]
启动服务器,试着访问“/polls/5/”,“/polls/5/results”,“/polls/5/vote”。Django会根据url不同找到对应的视图函数并返回结果给页面显示。
更改视图函数,使其具有业务逻辑
上边的视图函数只是验证根据不同的url可以访问不同的视图函数,并没有实际的业务逻辑。现在改写视图函数实其具有简单的业务逻辑。每个视图函数最后返回的都是一个HttpResponse对象,对象中包含了请求的内容或者返回404页面不存在异常。不论返回请求的内容是什么,Django要的都是HttpResponse对象。
首先更改index视图函数:
from django.http import HttpResponse
from .models import Question
def index(request):
latest_question_list = Question.objects.order_by('-pub_date')[:5]
output = ', '.join([q.question_text for q in latest_question_list])
return HttpResponse(output)
# 其他视图函数暂时不变
index视图函数实现了获取数据库中的所有问题,并将其存为数组,通过HttpResponse对象返回。
新的问题
上述的逻辑可以实现在页面中显示问题列表,但是问题是如果我希望不改变数据但是改变页面的显示方式,我就不得不重新编写视图函数。这就很麻烦,所以为了解决这个问题,引入模板。通过模板,视图函数的主要逻辑就是获取数据,至于数据怎么显示,交给页面模板来处理。
引入模板
在polls目录下创建templates文件夹,Django会自动去该文件夹下寻找匹配模板。一般情况下,Django会在INSTALLED_APPS列表中每个app目录里的templates的子文件夹中寻找模板
在polls/templates文件夹下创建polls文件夹,然后在其中创建index.html。此时文件路径应该为:“polls/templates/polls/index.html”。index.html代码如下:
{% if latest_question_list %}
<ul>
{% for question in latest_question_list %}
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
{% endfor %}
</ul>
{% else %}
<p>No polls are available.</p>
{% endif %}
对应的polls/views.py文件中的index函数修改如下:
from django.http import HttpResponse
from django.template import loader
from .models import Question
def index(request):
latest_question_list = Question.objects.order_by('-pub_date')[:5]
template = loader.get_template('polls/index.html')
context = {
'latest_question_list': latest_question_list,
}
return HttpResponse(template.render(context, request))
render()函数的作用就是将给定的模板与给定的上下文字典相结合,并返回一个HttpResponse对象和呈现的文本。
快捷方式render()
上述的形式非常的常见,即获取内容,获取模板,然后结合,最后通过HttpResponse对象返回。所以,Django提供了一个简化版本:
from django.shortcuts import render
from .models import Question
def index(request):
latest_question_list = Question.objects.order_by('-pub_date')[:5]
context = {'latest_question_list': latest_question_list}
return render(request, 'polls/index.html', context)
404错误
与上述相似的过程处理detail()视图函数,代码如下:
from django.http import Http404
from django.shortcuts import render
from .models import Question
# ...
def detail(request, question_id):
try:
question = Question.objects.get(pk=question_id)
except Question.DoesNotExist:
raise Http404("Question does not exist")
return render(request, 'polls/detail.html', {'question': question})
注意到这里有一个异常处理,即当找不到内容时,抛出异常。对应的polls/templates/polls/detail.html中的内容:
{{ question }}
get_object_or_404()
上诉代码同样有一个快捷函数进行简化,detail()视图函数可以简写成:
from django.shortcuts import get_object_or_404, render
from .models import Question
# ...
def detail(request, question_id):
question = get_object_or_404(Question, pk=question_id)
return render(request, 'polls/detail.html', {'question': question})
与get_object_or_404()相似的,有一个函数为: get_list_or_404(),一个是获取对象,一个是获取列表
使用模板系统
回到detail.html,丰富一些内容:
<h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
<li>{{ choice.choice_text }}</li>
{% endfor %}
</ul>
视图函数返回的是question对象,但是因为外键关系,可以通过question.choice_set.all获取到该问题下的choices。
移除templates中的硬编码
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
这种硬编码、紧密耦合的方法的问题是,在具有大量模板的项目上更改url变得很有挑战性。但是由于在polls.urls模块中的path()函数中定义了name参数,您可以使用{% url %}模板标记删除对URL配置中定义的特定URL路径的依赖:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>
这种工作方式是在polls.url模块中寻找特定的URL定义,如下:
...
# the 'name' value as called by the {% url %} template tag
path('<int:question_id>/', views.detail, name='detail'),
...
如果想将detail视图的URL更改为其他地址,比如更改为polls/specifics/12/之类的内容,我们不用在模板(或多个模板)中进行更改,而是可以在polls/urls.py中进行更改。
...
# added the word 'specifics'
path('specifics/<int:question_id>/', views.detail, name='detail'),
...
使用命名空间区分不同app下的相同名称的视图
因为通常情况下,一个Django项目下可能会有多个apps。每个app下的视图命名很可能出现重复。因此需要使用命名空间将视图区分开,并在url中明确使用哪个命名空间下的视图:
在polls/urls.py 文件中,添加app_name = ‘polls’:
from django.urls import path
from . import views
app_name = 'polls'
urlpatterns = [
path('', views.index, name='index'),
path('<int:question_id>/', views.detail, name='detail'),
path('<int:question_id>/results/', views.results, name='results'),
path('<int:question_id>/vote/', views.vote, name='vote'),
]
然后修改polls/index.html 中的内容:
修改前:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>
修改后:
<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>
总结
这部分完成了两个视图,index和detail。主要流程如下:
这里需要注意的是:
- HttpResponse()可以省略。
- 对于带有处理异常机制的视图函数,可以使用get_object_or_404()或者get_list_or_404()简化代码。
- 避免html中URL的硬编码,改用{% url %}代替。
- 引入命名空间,确保Django可以区分不同app下的同名视图。