每个视图都负责做下面两件事中的一件:返回一个包含请求页内容的HttpResponse
对象,或者引发一个例如Http404
的异常。
你的视图可以阅读来自数据库的记录,它可以使用Django自身或第三方python的模版系统。它可以产生一个PDF文件、输出XML、创建zip文件或者你想要的任何东西,通过使用任何你想要使用的python库。
Django想要的一切就是HttpResponse
或者一个异常。因为方便,让我们来使用一下Django自己的数据库API吧。新的index()
视图将会展示系统中最新的5个投票问题。
def index(request):
latest_question_list=Question.objects.order_by('-pub_date')[:5]
output=', '.join([p.question_text for p in latest_question_list])
return output
但是这里有个问题,视图中的页面设计是硬编码的形式。如果你想改变页面的外观,你必须要编辑python的代码。我们可以创建一个视图可以使用的模版来将设计与python分开。
首先在你的polls
目录下创建一个templates
目录,Django会寻找那里的模版。你工程的TEMPLATES
设置描述了Django如何加载和渲染模版。默认的设置文件配置了一个DjangoTemplates
后台,它的APP_DIRS
选项被设置为True
。按照约定,DjangoTemplates
会寻找每个INSTALLED_APPS
中的templates
子目录。这就是为什么我们没有调整DIRS
选项但是Django还能知道polls的模板。
注意:我们可以让我们的模版放在一起,在一个大的模版目录总,它仍然工作的很好。但是,这个模板属于polls这个应用,所以不像之前创建的admin模版,我们这次将这个模版放在应用的模版目录中(即polls/templates
)而不是工程的模版目录中(即templates
)。
在刚刚创建的templates
目录中创建另一个目录polls
,在该目录下,创建一个文件index.html
。换句话说,你的模版目录是polls/templates/polls/index.html
注意:现在我们可能能够将我们的模版直接放在polls/templates
下面,而不创建另一个子目录polls
,但这是一个很不好的想法。Django将会选择它发现的第一个匹配名字的模版,如果你在一个不同的应用中有一个相同名字的模版,Django讲无法分辨它们,最简单的方式是通过命名空间来区分它们。也就是,通过将这些模版放在以工程名命名的另一个目录中。
将以下的代码放在模版中:
{% 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 RequestContext, 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 = RequestContext(request, {
'latest_question_list': latest_question_list,
})
return HttpResponse(template.render(context))
这段代码会加载polls/index.html
这个模版,并将它传给context,通过在浏览器中输入/polls/
加载网页,你可以看到一个列表,链接点会指向问题详情页。
捷径:render()
加载一个模版,填充context然后携带被渲染好的模版返回一个HttpResponse
对象,这是一个很常见的流程。Django提供一个捷径,这里用这个捷径重写下index()
:
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)
如果我们在所有视图中都这样做的话,我们不再需要到loader
、RequestContext
和HttpResponse
。render()
函数把请求对象作为它的第一个函数,模版名作为它的第二个参数,一个字典作为它的第三个可选参数。它返回一个用给定的context渲染的给定模版的HttpResponse
对象。
引起一个404错误
现在,让我来处理一下问题详情视图,这个页面将会展示给定投票的问题文本,下面给出了代码:
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})
这里有新的概念:视图将会引起Http404
异常,如果一个携带请求ID的问题不存在的话。稍后我们将讨论你可以在poll/detail.html
模版里面放的代码,如果你想要快速体验上面的例子,只需加入:
{{ question }}
捷径:get_object_or_404()
如果对象不存在的话,通常使用get()
和Http404
,Django提供了一个捷径,这里是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})