继续教程2来讲,我们继续poll应用,并专注于创建公共视图"views"。
概述
视图是django中web的一种"类型",通常服务一个特殊的函数,并有一个特别的模板。例如,在一个博客应用中,你可能会有如下的视图:
- 博客首页:展示最新的一些条目
- 进入“详细”页面: 链接到网页的单一入口
- 基于年份的归档页面:展示给定年份的条目
- 基于月份的归档页面:展示给定月份的条目
- 基于日期的归档页面:展示给定日期的所有条目
- 注释:给指定条目添加注释
在我们的poll应用中,我们有如下4个视图:
- Question的“index”页面:展示最近的几个“question”
- Question的“detail”页面:展示一个question文本,没有结果,但是有投票的表单。
- Question的“results”页面:展示指定问题的结果页面
- 投票:把指定的选项投票到指定问题
在Django中,网页和其他内容是由视图来交付的。每一个视图由一个python函数来表示(或者是方法,就基于类的视图来说)。Django会通过筛选请求中的url来选择视图(确切来说,是url中域名后面的部分)。
现在,你的web页面可能会出现像“ME2/Sites/dirmod.asp?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B”的内容,你将会跟高兴的发现,Django允许我们使用更优雅的URL模式。
URL模式是简单的URL的一般格式,例如:/newsarchive/<year>/<month>/
为了拿到指向视图的URL,Django使用了我们了解的“URLconfs”。URLconfs会把URL模式映射到视图上。
这个教程提供了URLconf的最基础的结构,你可以参考 URL dispatcher来找到更多信息。
编写更多的视图
现在我们想polls/views.py中添加更多视图吧。这些视图稍微有些不同,因为他们都传递了一个参数:
把这些新的视图加入到polls/urls模块,通过调用path()函数来添加。
看一下你的浏览器,url是“/poll/34”。它将会运行detail函数,并且在URL中展示任何你提供的ID。再尝试"/polls/34/results"和“polls/34/vote”,这些将会展示结果和投票页面的占位符。
当其他人请求你的网站的页面时-说“/polls/34”,Django会加载mysite.urls的python模块,因为它会指向 ROOT_URLCONF
设置。它发现了一个叫urlpatterns的变量,会按顺序放置url。返发现匹配到了“polls/”时,它会除去已经匹配过的“polls/”,继续匹配剩下的"34/"-从而进一步处理。它匹配到"<int: question_id>/"时,会调用detail()函数,就想下面这样:
question_id=34来自<int: question_id>,使用尖括号“捕获”的URL这部分会把它作为关键字参数发送到视图函数中。URL中的的question_id部分定义了标识匹配部分的名字,<int: 这部分是一个转换器,决定了匹配什么模式(url patterns)。
不需要加上文件后缀,除非你想这么做,你可以这样做:
但是,不要这么做,这很愚蠢。
写几个实际做事的视图
每一个视图函数都会做下面两件事中的一件:为请求页面返回一个包含内容的HttpResponse对象,或者抛出404异常。剩下的由你决定。
你的视图不管能不能读取数据库中的记录。它可以使用模板系统比如Django's-或一个第三方的python模板系统。它能生成一个pdf文件,输入XML,运行中创建一个ZIP文件,或者任何你想要的,可以使用任何你想使用的python库。
所有的Django都想要一个HttpResponse,或者是一个异常。
因为这很实用,让我们使用Django自己的数据库API,我们曾在教程2中提到过。这有一个新的index()视图函数,会展示系统中最后5个投票问题,根据发布时间用逗号分隔。
这有一个问题,虽然页面设计的是在视图中硬编码。如果你想改变页面看起来的方式,你就要编辑Python代码。所以,让我们用Django的模板系统来分隔python代码和页面,通过创建模板让视图来使用。
首先,在你的polls目录下创建一个templates目录。Django会在这里寻找模板。
你的项目中的TEMPLATES设置描述了Django会怎样加载和渲染模板。默认的配置文件配置了DjangoTemplates后端,那些配置了APP_DIRS选项为True的人。约定俗成,DjangoTemplates会在每个INSTALLED_APPS中的子目录寻找模板。
在你刚刚创建的那个templates目录里面,再创建一个叫"polls"的目录,在新创建的这个目录中创建一个“index.html”文件,换句话说,你的文件应该在“polls/templates/polls/index.html”。因为,app_directories模板加载器工作就像上面描述的这样,你可以指向这个模板,通过Django就像"polls/index.html"这样简单。
模板命名空间
现在我们可能要直接拿走polls/templates中的模板(而非创建另一个polls子目录),但是这实际上不是一个好主意,django会选择命名空间相匹配的第一个模板,如果你在不同的应用程序中有相同名字的模板,django将不能区分他们。我们需要让django知道指向正确的那个,最简单的办法就是通过命名空间来确定。也就是说,通过将这么模板放置在另一个应用名字的目录中。
把这些代码放入template:
现在,我们来更新我们polls/views.py中的视图函数,让它使用模板:
代码加载了"polls/index.html"模板,并它作为上下文传递进去。这里的上下文是指,把字典中的模板变量的名字映射成python对象。
在浏览器中加载“/polls/”,你将会看见一个包含教程2中"what's up"的question的无序列表。这个链接指向question的详情页面。
快捷方式:render()
这是一个非常常用的加载模板的习惯,填充一个向下文,并返回一个渲染了模板的HttpResponse对象。Django提供了一个捷径,来重写index()函数。
注意,一旦我们再所有的视图函数中这么做了,我们就不必再导入loader和HttpResponse了(你可能会保留HttpResponse,如果你的依然保留detail,results和votes方法的话)
render()函数把request对象作为第一个参数,模板名称作为第二个参数,以及一个字典作为第三个可选参数。它会返回一个HttpResponse对象,用指定上下文渲染好的指定模板。
抛出404错误
现在我们来处理question的详情页面-这个页面展示了要投票的question文本。下面是视图:
这有个新的概念:Http404异常,如果请求了一个不存在的id就会报错误。
稍后我们会讨论把什么放到polls/detail.html模板中,但是如果你想快点看到上面例子的结果,那么只包含下面的内容就够了:
现在就可以开始了。
捷径:get_object_or_404()
如果对象不存在,使用get()函数并抛出404错误时,这是一种很常见的用法。Django提供了一个捷径。这有一个detail()视图,重写如下:
get_object_or_404()函数以一个Django模型作为第一个参数,和一个任意数量的参数元祖,它会传递到模型的管理者的get()函数中,当对象不存在时抛出Http404。
哲学
为什么我们使用get_object_or_404()这个辅助函数来代替自动捕获OjbectDoesNotExist异常在更高的层级,或者让模型API抛出Http404异常替代OjbectDoesNotExist?
因为要结合模型层和视图层。最初的一个设计理念就是松耦合。一些可控的解耦操作在django.shortcuts
模型中都有介绍。
还有get_list_or_404(),和get_object_or_404()的原理类似-除了使用filter()函数来代替get()函数。当list为空时,抛出Http404异常。
使用模板系统
回到我们poll应用的detail()视图,给定的上下文变量question,这就是polls/detail.html模板可能看起来的样子:
模板使用.语法使用变量属性,例如,{{ question.question_text }},django以字典的方式在question对象上查找,如果没有,会尝试属性查找。如果属性查找失败,会尝试列表索引查找。
在 {% for %}
循环中进行方法调用:question.choice_set.all被解释为python代码中的question.choice_set.all(),返回一个可迭代的choise对象,适合用 {% for %}
标签。
阅读template guide来了解更多关于模板。
移除模板中的硬编码
我们在polls/index.html模板中写了一个到question的链接,这个链接的一部分就是硬编码:
硬编码的问题,会和改变项目中的模板的URL有着紧密的联系,然而,自从你在polls.urls木块中的path()函数中定义了参数的名字后,通过使用{% url %}模板标记可以解除特殊的URL路径问题。
方法就是通过寻找url在polls.urls模块中的定义。你可以清晰的看到名为“detail”的URL定义如下:
如果你想把polls的detail视图的URL改成其他的,也许是polls/specifics/12,你需要在polls/urls.py中改变它。
命名空间的URL命名
教程项目中只有一个应用,polls。在实际的django项目中,可能会有5个,10个,20个甚至更多的应用。Django是如何区分他们的URL呢?例如,polls应用有一个detail视图,也许项目中还有一个blog应用。如何让Django知道哪个应用程序视图创建一个url使用{ % url % }时模板标签呢?
答案是在你的URLconf中添加命名空间。在polls/urls.py中,在前面添加一个app_name来设置应用的命名空间:
现在修改你的polls/index.html模板:
指向detail视图的命名空间:
当你已经熟悉了编写视图页面时,阅读 part 4 of this tutorial来学习简单表单和一般视图的编写。