django教程-part3

继续教程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中添加更多视图吧。这些视图稍微有些不同,因为他们都传递了一个参数:


image.png

把这些新的视图加入到polls/urls模块,通过调用path()函数来添加。


image.png

看一下你的浏览器,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()函数,就想下面这样:

image.png

question_id=34来自<int: question_id>,使用尖括号“捕获”的URL这部分会把它作为关键字参数发送到视图函数中。URL中的的question_id部分定义了标识匹配部分的名字,<int: 这部分是一个转换器,决定了匹配什么模式(url patterns)。

不需要加上文件后缀,除非你想这么做,你可以这样做:


image.png

但是,不要这么做,这很愚蠢。


写几个实际做事的视图

每一个视图函数都会做下面两件事中的一件:为请求页面返回一个包含内容的HttpResponse对象,或者抛出404异常。剩下的由你决定。

你的视图不管能不能读取数据库中的记录。它可以使用模板系统比如Django's-或一个第三方的python模板系统。它能生成一个pdf文件,输入XML,运行中创建一个ZIP文件,或者任何你想要的,可以使用任何你想使用的python库。

所有的Django都想要一个HttpResponse,或者是一个异常。

因为这很实用,让我们使用Django自己的数据库API,我们曾在教程2中提到过。这有一个新的index()视图函数,会展示系统中最后5个投票问题,根据发布时间用逗号分隔。


image.png

这有一个问题,虽然页面设计的是在视图中硬编码。如果你想改变页面看起来的方式,你就要编辑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:


image.png

现在,我们来更新我们polls/views.py中的视图函数,让它使用模板:


image.png

代码加载了"polls/index.html"模板,并它作为上下文传递进去。这里的上下文是指,把字典中的模板变量的名字映射成python对象。

在浏览器中加载“/polls/”,你将会看见一个包含教程2中"what's up"的question的无序列表。这个链接指向question的详情页面。

快捷方式:render()

这是一个非常常用的加载模板的习惯,填充一个向下文,并返回一个渲染了模板的HttpResponse对象。Django提供了一个捷径,来重写index()函数。


image.png

注意,一旦我们再所有的视图函数中这么做了,我们就不必再导入loader和HttpResponse了(你可能会保留HttpResponse,如果你的依然保留detail,results和votes方法的话)

render()函数把request对象作为第一个参数,模板名称作为第二个参数,以及一个字典作为第三个可选参数。它会返回一个HttpResponse对象,用指定上下文渲染好的指定模板。


抛出404错误

现在我们来处理question的详情页面-这个页面展示了要投票的question文本。下面是视图:


image.png

这有个新的概念:Http404异常,如果请求了一个不存在的id就会报错误。

稍后我们会讨论把什么放到polls/detail.html模板中,但是如果你想快点看到上面例子的结果,那么只包含下面的内容就够了:


image.png

现在就可以开始了。

捷径:get_object_or_404()

如果对象不存在,使用get()函数并抛出404错误时,这是一种很常见的用法。Django提供了一个捷径。这有一个detail()视图,重写如下:


image.png

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模板可能看起来的样子:


image.png

模板使用.语法使用变量属性,例如,{{ question.question_text }},django以字典的方式在question对象上查找,如果没有,会尝试属性查找。如果属性查找失败,会尝试列表索引查找。

{% for %}循环中进行方法调用:question.choice_set.all被解释为python代码中的question.choice_set.all(),返回一个可迭代的choise对象,适合用 {% for %}标签。

阅读template guide来了解更多关于模板。


移除模板中的硬编码

我们在polls/index.html模板中写了一个到question的链接,这个链接的一部分就是硬编码:


image.png

硬编码的问题,会和改变项目中的模板的URL有着紧密的联系,然而,自从你在polls.urls木块中的path()函数中定义了参数的名字后,通过使用{% url %}模板标记可以解除特殊的URL路径问题。


image.png

方法就是通过寻找url在polls.urls模块中的定义。你可以清晰的看到名为“detail”的URL定义如下:


image.png

如果你想把polls的detail视图的URL改成其他的,也许是polls/specifics/12,你需要在polls/urls.py中改变它。


image.png

命名空间的URL命名

教程项目中只有一个应用,polls。在实际的django项目中,可能会有5个,10个,20个甚至更多的应用。Django是如何区分他们的URL呢?例如,polls应用有一个detail视图,也许项目中还有一个blog应用。如何让Django知道哪个应用程序视图创建一个url使用{ % url % }时模板标签呢?

答案是在你的URLconf中添加命名空间。在polls/urls.py中,在前面添加一个app_name来设置应用的命名空间:


image.png

现在修改你的polls/index.html模板:


image.png

指向detail视图的命名空间:


image.png

当你已经熟悉了编写视图页面时,阅读 part 4 of this tutorial来学习简单表单和一般视图的编写。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,686评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,668评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,160评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,736评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,847评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,043评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,129评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,872评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,318评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,645评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,777评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,470评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,126评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,861评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,589评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,687评论 2 351

推荐阅读更多精彩内容