原创作者: hideto
阅读:8146次
评论:1条
更新时间:2011-06-01
The Django Book：第3章 动态Web页面基础
revised by xin_wang
上一章我们解释了怎样开始一个Django项目和运行Django服务器
当然了，这个站点实际上什么也没有做------除了显示了"It worked"这条信息以外。
这一章我们介绍怎样使用Django创建动态网页
你的第一个视图：动态内容
让我们创建一个显示当前日期和时间的Web页面来作为你的第一个目标
这是一个动态Web页面的例子，因为页面内容根据计算当前时间而变化
这个例子不需要数据库和任何用户输入，只是输出服务器内部时钟
我们将写一个视图方法，它只是一个Python方法，接受Web请求并返回Web应答
这个应答可以是HTML内容、重定向、404错误、XML文档、图像等等
视图本身包含任意必要的逻辑来返回应答
在这里视图作为HTML文档返回当前日期和时间
让我们来看看代码
1，首先，我们从django.http模块import HttpResponse类
2，然后，我们从Python标准库import datetime模块
datetime模块包含一些处理日期和时间的类和方法，并且包含一个返回当前时间的方法
3，然后，我们定义current_datetime方法
这是一个视图方法，它使用一个HttpRequest对象作为它的第一个参数
每个视图方法都使用HttpRequest对象作为自己的第一个参数
在这个方法里，我们把这个参数叫做request
Django并不关心视图方法的名字，我们也不必遵循某种特定的命名方式供Django鉴别。我们以current_datetime命名这个方法
纯粹是因为它正好可以明确的表达方法的意图，你可以任意地命名view方法，current_datetime清楚的表明了它会做什么事情
一会我们会解释Django怎样找到这个方法
4，该方法的第一行代码计算当前日期和时间，并存储在本地变量now中
5，该方法的第二行代码使用Python的格式化string能力构建了一个HTML应答
string里面的%s是一个占位符，string后面的百分号表示使用now变量的值代替%s
(给html纯化论者们：我们没有写DOCTYPE申明，没有<head>标签，等等等等，我们只是尽量让这个页面简洁明了。)
6，最后，视图返回一个包含生成的HTML的HttpResponse对象
每个视图方法都会返回一个HttpResponse对象，例外的情况我们后面会解释
你的第一个URL配置
这个视图方法返回了一个包含当前日期和时间的HTML页面
但是这些代码应该放在哪？怎样告诉Django使用这些代码呢？
第一个问题的答案是：你可以把view的代码放在任何位置，只要它是在你的Python PATH下，没有任何其他的要求----没有"魔术"。
我们将这些代码保存在views.py里面，并将views.py放在mysite目录下
Python PATH是一个你系统的目录列表，当你使用Python import语句时Python会查看这些目录
例如你的Python PATH设置成['', '/usr/lib/python2.4/site-packages', '/home/mycode']
如果你执行代码from foo import bar，Python将首先在当前目录下查找叫foo.py的模块
第一个Python PATH为空string，这表示当前目录
如果找不到foo.py，Python将尝试查找/usr/lib/python2.4/site-packages/foo.py
最后，如果foo.py还是找不到，Python将报ImportError
如果你有兴趣查看Python PATH，进入Python交互环境并输入import sys和print sys.path
一般来说你不必担心设置Python PATH，Python和Django会暗中自动为你做这些事情
如果你实在好奇，设置Python PATH是manage.py的一个工作
我们怎么告诉Django使用这些视图代码？答案是URL配置
URLConf就像是一张Django web站点的内容表格。基本上，这个配置是一个URL模式和对应的view函数的映射，这些函数会在请求某个符合特定模式的URL时被调用。
URLconf就是告诉Django，"对于这个URL，调用这些代码，对于那个URL，调用那些代码..."
URL配置就像是你的Django项目的目录
基本上，它是URL模式和URL模式调用的视图方法的映射
django-admin.py startproject会自动生成一个URL配置文件urls.py，默认情况下它是这样的：
让我们来看看这些代码
1，第一行import django.conf.urls.defaults模块的所有对象，包括一个叫patterns的方法
2，第二行调用patterns()方法并将接过保存到urlpatterns变量，patterns()方法只传了一个空string作为参数
其它行被注释掉了
这里主要看的就是变量urlpatterns，它定义了URL和处理URL的代码的映射
默认情况下所有的URL配置被注释掉了，这意味着你的Django项目是空的，这让Django得知显示“It worked!”页面
如果你的URL配置是空的，Django假设你刚开始一个新的项目，这样就显示这条信息
让我们编辑urls.py来暴露current_datetime视图：
我们做了两处改动。首先，我们从mysite/views.py模块import current_datetime视图
该模块在Python的import语法中被转换成mysite.views
然后我们增加一行(r'^now/$', current_datetime)，它指向一个URL模式
这是一个Python元组，第一个元素是一个正则表达式，第一个是视图方法
这样，我们就告知Django对URL /now/的请求应该被current_datetime视图方法处理
注意几个地方：
1，在例子中，我们把视图方法current_datetime当成对象传递而不是调用这个方法
这是Python及其它动态语言的特性，函数是第一类对象，可以像其它变量一样传递，cool吧？
2，不必在'^now/$'前面增加斜线来匹配/now/，Django自动在每个表达式前面添加斜线
3，'^'和'$'符号很重要，前者表示“匹配string的开始的模式”，后者表示“匹配string结束的模式”
这个例子很好的解释了概念问题，如果我们使用模式'^now/'，则/now/，/now/foo，/now/bar都将匹配
如果我们使用模式'now/$'则/now/，/foo/bar/now/等也将匹配
所以我们使用'^now/$'，则不多不少只有/now/匹配
现在测试一下我们对URLConf的修改。运行python manage.py runserver来启动Django的开发服务器
（如果让它一直运行也没有问题，服务器会自动探测Python代码的修改，在必要的时候重新载入，所以没有必要一修改就重起）
浏览器访问http://127.0.0.1:8000/now/测试一下
万岁!你已经开发了你的第一个Django-powered Web页面
Django怎样处理请求
Django怎样处理Web请求？让我们来看看事实真相
1，命令python manage.py runserver寻找settings.py，这个文件包含了这个Django实例的所有配置选项
最重要的设置是ROOT_URLCONF，它告诉Django使用哪个Python模块作为当前站点的URL配置
2，当一个请求进来如/now/，Django载入URL配置，然后按顺序检查每个URL模式直到找到一个匹配的URL请求模式
然后Django调用那个模式匹配的方法，并传递一个HttpRequest对象作为第一个参数
3，视图方法负责返回一个HttpResponse对象
这样你就了解了Django-powerd页面的基础，它很简单，只需写视图方法和通过URL配置映射到URL
URL配置和松耦合
现在是指出URL配置和Django后面的哲学的良好时机：松耦合原则
松耦合是具有使得部分模块可替换的价值的软件开发方法
如果两个模块是松耦合的，那么对一个模块做改动不会或很少对另一个有影响
Django的URL配置是这个原则的很好的例子
在Django Web程序中，URL定义和视图方法是松耦合的，开发人员可以替换其中一个而不会对另一个产生影响
对比之下，其他的web开发平台耦合了URL和程序，例如在basic php中，应用的URL取决于代码在文件系统中的位置，
在CherryPy框架中，URL和应用中的方法名称是相对应的。这些方式看来非常方便，但是长远来看会造成难以管理的问题
举例来说，考虑我们刚刚的那个显示当前时间的函数。如果我们想改变这个应用的URL，比如从/now/变成/currenttime/
我们可以对URLconf做一个非常快捷的修改，不用担心隐藏在这个URL之后的函数实现。类似的，如果我们想修改view函数
修改它的逻辑，我们用不着影响URL就可以做到。
更进一步，如果我们想把这个当前时间的方法暴露到多个URL上，我们也可以通过修改URLconf轻易完成，而无需影响view的代码。
404错误
在我们当前的URLconf里面只有一个处理/now/的URL模式。如果我们请求一个不同的URL会发生什么呢？
当访问一个没有在URLconf里面定义过的URL时，你将看到一个"Page not found"的信息，因为这个URL还没有定义在URLconf里。
这个页面的用途其实不仅仅是显示404错误信息：它精确的告诉我们Django使用了哪一个URLconf，以及这个配置里的每一个URL匹配模式。
通过这个页面我们可以轻易的得知为什么请求的URL抛出了404错误。
当然了，这些信息的初衷是为了方便web开发者。如果这是一个实际的internet站点，我们不希望这些信息被泄露出去。
出于这个原因，这个"Page not found"页面只显示在debug模式下。
你的第二个视图：动态URL
第一个视图例子中，页面内容当前日期和时间是动态的，但是URL("/now/")是静态的
大多数动态Web程序中，URL包含了影响输出页面的参数
下面的例子中我们使用一个数字来显示为了几小时的日期和时间
如/now/plus1hour/显示未来1小时的时间，/now/plus3hour/显示未来3小时的时间
先修改URL配置：
显然这样的模式有缺陷，不仅会产生大量的视图方法，还将程序局限在预先定义的小时范围内
如果我们想显示5小时后的时间，我们还得再添加一行
所以我们应该在这里做出一点抽象
关于良好的URL
如果你使用过PHP或Java，你可能会说“让我们使用一个查询参数”，类似于像/now/plus?hours=3
你也可以使用Django这样做，但是Django的一个核心哲学是，URL应该是优雅的
/now/plus3hours/更干净、更简单、更可读、更朗朗上口
良好的URL是Web程序质量的一个显示
Django的URL配置系统提供容易配置的良好的URL定义
URL模式通配符
继续我们的例子，让我们在URL模式中添加一个通配符
上面提到，URL模式是一个正则表达式，这里我们可以使用\d+来匹配1个或多个数字：
这个URL模式可以匹配任何URL，例如/now/plus2hours/，/now/plus25hours/，甚至/now/plus100000000000hours/
让我们限制最多99小时，即我们只允许1个或2个数字，在正则表达式里就是\d{1,2}：
(r'^now/plus\d{1,2}hours/$', hours_ahead),
当我们构建web程序的时候，考虑可能出现的不合常理的输入， 并且决定是否处理这些输入是非常重要的。
我们在这里限制时间的偏移量<=99小时。顺便啰嗦一句，Outlandishness Curtailers是个超级棒的乐队。
正则表达式是一个在文本里面指定模式的简洁方式
Django的URL配置允许任意的正则表达式来提供强大的URL匹配能力，下面是一些常用的模式：
更多的正则表达式信息请查看Appendix 9，正则表达式
好了，我们已经在URL里设计了一个通配符，但我们需要把信息传递给视图方法
这样我们才能使用一个单独的视图方法来处理任意的小时参数
我们把我们在URL模式里希望保存的数据用括号括起来，即把\d{1,2}括起来
(r'^now/plus(\d{1,2})hours/$', hours_ahead),
如果你熟悉正则表达式，你会觉得非常亲切：我们正是在使用括号从匹配的文本中获得我们想要的数据。
最终的URL配置如下：
下面我们定义hours_ahead方法：
告诫:关于编码的顺序
在这个例子里面,我们先定义了URL模式，然后才开始撰写view代码，但是在前一个例子里，编码的顺序正好相反。那么哪一种方式更好呢？
当然，每一个开发人员都有不一样的习惯。
如果你是一个大局观很好的人，一次性就定义好所有的URL模式，然后再来实现view的代码，这是非常不错的。
这种方式能够展现一个非常清晰的to-do list，因为它从根本上定义了将要实现的view函数所需的参数。
如果你是一个有着自底向上的习惯的程序员，你也许更愿意写一个view，然后把它和某一个URL模式绑定起来。这样做也不错。
两种方式当然都是正确的，使用哪一个取决于哪一种更加符合你思考的模式。
我们还是一次一行的解读这些代码:
跟我们在current_datetime里所做的一样，我们导入了django.http.HttpResponse和datetime模块
view函数hours_ahead接受两个参数：request和offset。
request是一个HttpRequest对象，和在current_datetime中一样。我们要重申一点：每一个view函数的第一个参数总是HttpRequest对象。
offset是一个string，它的值是通过URL模式里的那一对括号从请求的URL中得到的。比如请求的URL是/now/plus3hours/
offset的值就是一个string‘3’。请注意从URL中得到的值始终是string而不是integer，即使这个string是由纯数字构成的。
我们把这个变量命名为offset，但是你可以用任何合法的Python变量名来命名它。变量的名字并不重要，但是必须是view函数的第二个参数。
在函数里我们做的第一件事就是调用int()，把offset转换成整形。
如果一个值不能被转换成为一个整型数（像字符串'foo'）， Python将会抛出ValueError。
但是我们对此并不担心，因为我们可以肯定offset一定可以被转换，正则表达式\d{1,2}一定会从URL中获得数字。
这也从另一个侧面证明了URLconf的优雅：它相当清楚地提供了一个对输入的校验。
程序的下一行揭示了我们对offset做类型转换的原因，这行代码计算了当前的时间加上一个时间偏移量，这个偏移量的值就是offset
保存计算的结果在变量dt.datetime.timedelta函数需要的输入参数就是整型。
下一行我们构造一个html的输出，和在current_datetime函数中类似。
最后，和current_datetime函数一样，我们返回一个HttpResponse对象。
好了，我们访问http://127.0.0.1:8000/now/plus3hours/可以验证它工作了
然后我们试试http://127.0.0.1:8000/now/plus100hours/，Django显示“Page not found”错误
http://127.0.0.1:8000/plushours/也会显示404错误，因为我们只接受1个或2个数字的参数
Django良好的出错页面
我们将offset = int(offset)注释掉
# offset = int(offset)
然后重新访问/now/plus3hours，你将看到一个很多信息的出错页面，包括TypeError信息在最上面：
“unsupported type for timedelta hours component: str”
发生了什么？
datetime.timedelta函数预期hours参数为integer类型，但我们注释掉了把offset转化为integer的代码
这导致datetime.timedelta产生TypeError，只是典型的每个程序员容易出现的小bug
中一些需要注意的地方：
1，页面的顶端显示的是关于异常的主要信息：异常的类型，异常的参数，导致异常的文件和行数
2，接下来页面显示完整的异常的Python traceback，在stack的每个frame里Django都显示了文件名、方法名、行数和该行代码
点击暗灰色的代码，你可以看到出错行前后的几行代码，让你得到上下文
点击“Local vars”可以看到所有的本地变量的列表，变量值，出错点等，这个debug信息是很有价值的
3，点击在“Traceback”下面的“Switch to copy-and-paste view”将切换到可以很容易复制粘贴的版本
当你想同他人分享异常信息或得到技术支持时(Django IRC聊天室或者Django用户邮件列表)可以很好的利用它
4，“Request information”包括大量的产生错误的Web请求的信息，GET和POST信息，cookie值和meta信息如CGI头部等
下面的“Settings”部分列出了当前Django安装的所有设置信息，后面我们会慢慢解释这些
Django错误页面在模板语法错误等情况下会显示更丰富的信息，现在去掉注释offset=int(offset)
你是那种喜欢用print语句debug 的程序员吗？使用Django错误页面就可以做到这点，不需要print语句
你可以临时插入assert False来触发错误页面，后面我们会解释更高级的debug方法
很显然大部分这些错误信息是敏感的，它暴露了你的Python代码和Django配置的五脏六腑
把这些信息显示到网上是愚蠢的，心怀恶意的人可能会在你的网站里面做肮脏的事情
无论如何，后面我们会提到怎样去除debug模式
练习
这里是一些巩固本章知识的练习，我们在这里介绍了一些新的技巧
1，创建另一个视图hours_behind，类似于hours_ahead，只不过显示过去的时间偏移量
这个视图应该绑定到/now/minusXhours/，这里X是偏移量小时数
2，一旦你做完练习1，一个良好的程序员会发现hours_ahead和hours_behind非常类似，这显得多余了
把这两个方法合并到单独的一个方法hour_offset，URL还是保持/now/minusXhours/和/now/plusXhours/不变
别忘了根据偏移量是正还是负来改变HTML代码，“In X hour(s)”或者“X hour(s) ago”
3，让我们更专业一点，允许/now/plus1hour/和/now/plus2hours/，但是不允许/now/plus1hours/和/now/plus2hour/
4，在HTML的显示里，如果偏移量是个位数，使用hour，否则使用hours
答案
1，hours_behind视图：
URL模式：
2，hour_offset视图：
URL模式：
3，URL模式：
其中“|”表示“or”，上面的模式表示匹配模式[2-9]或者\d\d
即匹配一个2到9的数字或者匹配两个数字
4，hour_offset视图：
难道不能把展现层代码从Python代码里分离出去吗？呵呵，这预示着......
revised by xin_wang
上一章我们解释了怎样开始一个Django项目和运行Django服务器
当然了，这个站点实际上什么也没有做------除了显示了"It worked"这条信息以外。
这一章我们介绍怎样使用Django创建动态网页
你的第一个视图：动态内容
让我们创建一个显示当前日期和时间的Web页面来作为你的第一个目标
这是一个动态Web页面的例子，因为页面内容根据计算当前时间而变化
这个例子不需要数据库和任何用户输入，只是输出服务器内部时钟
我们将写一个视图方法，它只是一个Python方法，接受Web请求并返回Web应答
这个应答可以是HTML内容、重定向、404错误、XML文档、图像等等
视图本身包含任意必要的逻辑来返回应答
在这里视图作为HTML文档返回当前日期和时间
from django.http import HttpResponse import datetime def current_datetime(request): now = datetime.datetime.now() html = "It is now %s." % now return HttpResponse(html)
让我们来看看代码
1，首先，我们从django.http模块import HttpResponse类
2，然后，我们从Python标准库import datetime模块
datetime模块包含一些处理日期和时间的类和方法，并且包含一个返回当前时间的方法
3，然后，我们定义current_datetime方法
这是一个视图方法，它使用一个HttpRequest对象作为它的第一个参数
每个视图方法都使用HttpRequest对象作为自己的第一个参数
在这个方法里，我们把这个参数叫做request
Django并不关心视图方法的名字，我们也不必遵循某种特定的命名方式供Django鉴别。我们以current_datetime命名这个方法
纯粹是因为它正好可以明确的表达方法的意图，你可以任意地命名view方法，current_datetime清楚的表明了它会做什么事情
一会我们会解释Django怎样找到这个方法
4，该方法的第一行代码计算当前日期和时间，并存储在本地变量now中
5，该方法的第二行代码使用Python的格式化string能力构建了一个HTML应答
string里面的%s是一个占位符，string后面的百分号表示使用now变量的值代替%s
(给html纯化论者们：我们没有写DOCTYPE申明，没有<head>标签，等等等等，我们只是尽量让这个页面简洁明了。)
6，最后，视图返回一个包含生成的HTML的HttpResponse对象
每个视图方法都会返回一个HttpResponse对象，例外的情况我们后面会解释
你的第一个URL配置
这个视图方法返回了一个包含当前日期和时间的HTML页面
但是这些代码应该放在哪？怎样告诉Django使用这些代码呢？
第一个问题的答案是：你可以把view的代码放在任何位置，只要它是在你的Python PATH下，没有任何其他的要求----没有"魔术"。
我们将这些代码保存在views.py里面，并将views.py放在mysite目录下
Python PATH是一个你系统的目录列表，当你使用Python import语句时Python会查看这些目录
例如你的Python PATH设置成['', '/usr/lib/python2.4/site-packages', '/home/mycode']
如果你执行代码from foo import bar，Python将首先在当前目录下查找叫foo.py的模块
第一个Python PATH为空string，这表示当前目录
如果找不到foo.py，Python将尝试查找/usr/lib/python2.4/site-packages/foo.py
最后，如果foo.py还是找不到，Python将报ImportError
如果你有兴趣查看Python PATH，进入Python交互环境并输入import sys和print sys.path
一般来说你不必担心设置Python PATH，Python和Django会暗中自动为你做这些事情
如果你实在好奇，设置Python PATH是manage.py的一个工作
我们怎么告诉Django使用这些视图代码？答案是URL配置
URLConf就像是一张Django web站点的内容表格。基本上，这个配置是一个URL模式和对应的view函数的映射，这些函数会在请求某个符合特定模式的URL时被调用。
URLconf就是告诉Django，"对于这个URL，调用这些代码，对于那个URL，调用那些代码..."
URL配置就像是你的Django项目的目录
基本上，它是URL模式和URL模式调用的视图方法的映射
django-admin.py startproject会自动生成一个URL配置文件urls.py，默认情况下它是这样的：
from django.conf.urls.defaults import *
urlpatterns = patterns('',
# Example:
# (r'^mysite/', include('mysite.apps.foo.urls.foo')),
# Uncomment this for admin:
# (r'^admin/', include('django.contrib.admin.urls')),
)
让我们来看看这些代码
1，第一行import django.conf.urls.defaults模块的所有对象，包括一个叫patterns的方法
2，第二行调用patterns()方法并将接过保存到urlpatterns变量，patterns()方法只传了一个空string作为参数
其它行被注释掉了
这里主要看的就是变量urlpatterns，它定义了URL和处理URL的代码的映射
默认情况下所有的URL配置被注释掉了，这意味着你的Django项目是空的，这让Django得知显示“It worked!”页面
如果你的URL配置是空的，Django假设你刚开始一个新的项目，这样就显示这条信息
让我们编辑urls.py来暴露current_datetime视图：
from django.conf.urls.defaults import *
form mysite.views import current_datetime
urlpatterns = patterns('',
(r'^now/$', current_datetime),
)
我们做了两处改动。首先，我们从mysite/views.py模块import current_datetime视图
该模块在Python的import语法中被转换成mysite.views
然后我们增加一行(r'^now/$', current_datetime)，它指向一个URL模式
这是一个Python元组，第一个元素是一个正则表达式，第一个是视图方法
这样，我们就告知Django对URL /now/的请求应该被current_datetime视图方法处理
注意几个地方：
1，在例子中，我们把视图方法current_datetime当成对象传递而不是调用这个方法
这是Python及其它动态语言的特性，函数是第一类对象，可以像其它变量一样传递，cool吧？
2，不必在'^now/$'前面增加斜线来匹配/now/，Django自动在每个表达式前面添加斜线
3，'^'和'$'符号很重要，前者表示“匹配string的开始的模式”，后者表示“匹配string结束的模式”
这个例子很好的解释了概念问题，如果我们使用模式'^now/'，则/now/，/now/foo，/now/bar都将匹配
如果我们使用模式'now/$'则/now/，/foo/bar/now/等也将匹配
所以我们使用'^now/$'，则不多不少只有/now/匹配
现在测试一下我们对URLConf的修改。运行python manage.py runserver来启动Django的开发服务器
（如果让它一直运行也没有问题，服务器会自动探测Python代码的修改，在必要的时候重新载入，所以没有必要一修改就重起）
浏览器访问http://127.0.0.1:8000/now/测试一下
万岁!你已经开发了你的第一个Django-powered Web页面
Django怎样处理请求
Django怎样处理Web请求？让我们来看看事实真相
1，命令python manage.py runserver寻找settings.py，这个文件包含了这个Django实例的所有配置选项
最重要的设置是ROOT_URLCONF，它告诉Django使用哪个Python模块作为当前站点的URL配置
2，当一个请求进来如/now/，Django载入URL配置，然后按顺序检查每个URL模式直到找到一个匹配的URL请求模式
然后Django调用那个模式匹配的方法，并传递一个HttpRequest对象作为第一个参数
3，视图方法负责返回一个HttpResponse对象
这样你就了解了Django-powerd页面的基础，它很简单，只需写视图方法和通过URL配置映射到URL
URL配置和松耦合
现在是指出URL配置和Django后面的哲学的良好时机：松耦合原则
松耦合是具有使得部分模块可替换的价值的软件开发方法
如果两个模块是松耦合的，那么对一个模块做改动不会或很少对另一个有影响
Django的URL配置是这个原则的很好的例子
在Django Web程序中，URL定义和视图方法是松耦合的，开发人员可以替换其中一个而不会对另一个产生影响
对比之下，其他的web开发平台耦合了URL和程序，例如在basic php中，应用的URL取决于代码在文件系统中的位置，
在CherryPy框架中，URL和应用中的方法名称是相对应的。这些方式看来非常方便，但是长远来看会造成难以管理的问题
举例来说，考虑我们刚刚的那个显示当前时间的函数。如果我们想改变这个应用的URL，比如从/now/变成/currenttime/
我们可以对URLconf做一个非常快捷的修改，不用担心隐藏在这个URL之后的函数实现。类似的，如果我们想修改view函数
修改它的逻辑，我们用不着影响URL就可以做到。
更进一步，如果我们想把这个当前时间的方法暴露到多个URL上，我们也可以通过修改URLconf轻易完成，而无需影响view的代码。
404错误
在我们当前的URLconf里面只有一个处理/now/的URL模式。如果我们请求一个不同的URL会发生什么呢？
当访问一个没有在URLconf里面定义过的URL时，你将看到一个"Page not found"的信息，因为这个URL还没有定义在URLconf里。
这个页面的用途其实不仅仅是显示404错误信息：它精确的告诉我们Django使用了哪一个URLconf，以及这个配置里的每一个URL匹配模式。
通过这个页面我们可以轻易的得知为什么请求的URL抛出了404错误。
当然了，这些信息的初衷是为了方便web开发者。如果这是一个实际的internet站点，我们不希望这些信息被泄露出去。
出于这个原因，这个"Page not found"页面只显示在debug模式下。
你的第二个视图：动态URL
第一个视图例子中，页面内容当前日期和时间是动态的，但是URL("/now/")是静态的
大多数动态Web程序中，URL包含了影响输出页面的参数
下面的例子中我们使用一个数字来显示为了几小时的日期和时间
如/now/plus1hour/显示未来1小时的时间，/now/plus3hour/显示未来3小时的时间
先修改URL配置：
urlpatterns = patterns('',
(r'^now/$', current_datetime),
(r'^now/plus1hour/$', one_hour_ahead),
(r'^now/plus2hour/$', two_hours_ahead),
(r'^now/plus3hour/$', three_hours_ahead),
{r'^now/plus4hour/$', four_hours_ahead),
)
显然这样的模式有缺陷，不仅会产生大量的视图方法，还将程序局限在预先定义的小时范围内
如果我们想显示5小时后的时间，我们还得再添加一行
所以我们应该在这里做出一点抽象
关于良好的URL
如果你使用过PHP或Java，你可能会说“让我们使用一个查询参数”，类似于像/now/plus?hours=3
你也可以使用Django这样做，但是Django的一个核心哲学是，URL应该是优雅的
/now/plus3hours/更干净、更简单、更可读、更朗朗上口
良好的URL是Web程序质量的一个显示
Django的URL配置系统提供容易配置的良好的URL定义
URL模式通配符
继续我们的例子，让我们在URL模式中添加一个通配符
上面提到，URL模式是一个正则表达式，这里我们可以使用\d+来匹配1个或多个数字：
from django.conf.urls.defaults import *
from mysite.views import corruent_datetime, hours_ahead
urlpatterns = patterns('',
(r'^now/$', current_datetime),
(r'^now/plus\d+hours/$', hours_ahead),
)
这个URL模式可以匹配任何URL，例如/now/plus2hours/，/now/plus25hours/，甚至/now/plus100000000000hours/
让我们限制最多99小时，即我们只允许1个或2个数字，在正则表达式里就是\d{1,2}：
(r'^now/plus\d{1,2}hours/$', hours_ahead),
当我们构建web程序的时候，考虑可能出现的不合常理的输入， 并且决定是否处理这些输入是非常重要的。
我们在这里限制时间的偏移量<=99小时。顺便啰嗦一句，Outlandishness Curtailers是个超级棒的乐队。
正则表达式是一个在文本里面指定模式的简洁方式
Django的URL配置允许任意的正则表达式来提供强大的URL匹配能力，下面是一些常用的模式：
Symbol Matches
.(dot) 任意字符
\d 任意数字
[A-Z] 从A到Z的任意字符(大写)
[a-z] 从a到z的任意字符(小写)
[A-Za-z] 从a到z的任意字符(大小写不敏感)
[^/]+ 任意字符直到一个前斜线(不包含斜线本身)
+ 一个或多个前面的字符
? 零个或多个前面的字符
{1,3} 1个到3个之间前面的字符(包括1和3)
更多的正则表达式信息请查看Appendix 9，正则表达式
好了，我们已经在URL里设计了一个通配符，但我们需要把信息传递给视图方法
这样我们才能使用一个单独的视图方法来处理任意的小时参数
我们把我们在URL模式里希望保存的数据用括号括起来，即把\d{1,2}括起来
(r'^now/plus(\d{1,2})hours/$', hours_ahead),
如果你熟悉正则表达式，你会觉得非常亲切：我们正是在使用括号从匹配的文本中获得我们想要的数据。
最终的URL配置如下：
from django.conf.urls.defautls import *
form mysite.views import current_datetime, hours_ahead
urlpatterns = patterns('',
(r'^now/$', current_datetime),
(r'^now/plus(\d{1,2})hours/$', hours_ahead),
)
下面我们定义hours_ahead方法：
告诫:关于编码的顺序
在这个例子里面,我们先定义了URL模式，然后才开始撰写view代码，但是在前一个例子里，编码的顺序正好相反。那么哪一种方式更好呢？
当然，每一个开发人员都有不一样的习惯。
如果你是一个大局观很好的人，一次性就定义好所有的URL模式，然后再来实现view的代码，这是非常不错的。
这种方式能够展现一个非常清晰的to-do list，因为它从根本上定义了将要实现的view函数所需的参数。
如果你是一个有着自底向上的习惯的程序员，你也许更愿意写一个view，然后把它和某一个URL模式绑定起来。这样做也不错。
两种方式当然都是正确的，使用哪一个取决于哪一种更加符合你思考的模式。
from django.http import HttpResponse import datetime def hours_ahead(request, offset): offset = int(offset) dt = datetime.datetime.now() + datetime.timedelta(hours=offset) html = "In %s hour(s), it will be %s." % (offset, dt) return HttpResponse(html)
我们还是一次一行的解读这些代码:
跟我们在current_datetime里所做的一样，我们导入了django.http.HttpResponse和datetime模块
view函数hours_ahead接受两个参数：request和offset。
request是一个HttpRequest对象，和在current_datetime中一样。我们要重申一点：每一个view函数的第一个参数总是HttpRequest对象。
offset是一个string，它的值是通过URL模式里的那一对括号从请求的URL中得到的。比如请求的URL是/now/plus3hours/
offset的值就是一个string‘3’。请注意从URL中得到的值始终是string而不是integer，即使这个string是由纯数字构成的。
我们把这个变量命名为offset，但是你可以用任何合法的Python变量名来命名它。变量的名字并不重要，但是必须是view函数的第二个参数。
在函数里我们做的第一件事就是调用int()，把offset转换成整形。
如果一个值不能被转换成为一个整型数（像字符串'foo'）， Python将会抛出ValueError。
但是我们对此并不担心，因为我们可以肯定offset一定可以被转换，正则表达式\d{1,2}一定会从URL中获得数字。
这也从另一个侧面证明了URLconf的优雅：它相当清楚地提供了一个对输入的校验。
程序的下一行揭示了我们对offset做类型转换的原因，这行代码计算了当前的时间加上一个时间偏移量，这个偏移量的值就是offset
保存计算的结果在变量dt.datetime.timedelta函数需要的输入参数就是整型。
下一行我们构造一个html的输出，和在current_datetime函数中类似。
最后，和current_datetime函数一样，我们返回一个HttpResponse对象。
好了，我们访问http://127.0.0.1:8000/now/plus3hours/可以验证它工作了
然后我们试试http://127.0.0.1:8000/now/plus100hours/，Django显示“Page not found”错误
http://127.0.0.1:8000/plushours/也会显示404错误，因为我们只接受1个或2个数字的参数
Django良好的出错页面
我们将offset = int(offset)注释掉
# offset = int(offset)
然后重新访问/now/plus3hours，你将看到一个很多信息的出错页面，包括TypeError信息在最上面：
“unsupported type for timedelta hours component: str”
发生了什么？
datetime.timedelta函数预期hours参数为integer类型，但我们注释掉了把offset转化为integer的代码
这导致datetime.timedelta产生TypeError，只是典型的每个程序员容易出现的小bug
中一些需要注意的地方：
1，页面的顶端显示的是关于异常的主要信息：异常的类型，异常的参数，导致异常的文件和行数
2，接下来页面显示完整的异常的Python traceback，在stack的每个frame里Django都显示了文件名、方法名、行数和该行代码
点击暗灰色的代码，你可以看到出错行前后的几行代码，让你得到上下文
点击“Local vars”可以看到所有的本地变量的列表，变量值，出错点等，这个debug信息是很有价值的
3，点击在“Traceback”下面的“Switch to copy-and-paste view”将切换到可以很容易复制粘贴的版本
当你想同他人分享异常信息或得到技术支持时(Django IRC聊天室或者Django用户邮件列表)可以很好的利用它
4，“Request information”包括大量的产生错误的Web请求的信息，GET和POST信息，cookie值和meta信息如CGI头部等
下面的“Settings”部分列出了当前Django安装的所有设置信息，后面我们会慢慢解释这些
Django错误页面在模板语法错误等情况下会显示更丰富的信息，现在去掉注释offset=int(offset)
你是那种喜欢用print语句debug 的程序员吗？使用Django错误页面就可以做到这点，不需要print语句
你可以临时插入assert False来触发错误页面，后面我们会解释更高级的debug方法
很显然大部分这些错误信息是敏感的，它暴露了你的Python代码和Django配置的五脏六腑
把这些信息显示到网上是愚蠢的，心怀恶意的人可能会在你的网站里面做肮脏的事情
无论如何，后面我们会提到怎样去除debug模式
练习
这里是一些巩固本章知识的练习，我们在这里介绍了一些新的技巧
1，创建另一个视图hours_behind，类似于hours_ahead，只不过显示过去的时间偏移量
这个视图应该绑定到/now/minusXhours/，这里X是偏移量小时数
2，一旦你做完练习1，一个良好的程序员会发现hours_ahead和hours_behind非常类似，这显得多余了
把这两个方法合并到单独的一个方法hour_offset，URL还是保持/now/minusXhours/和/now/plusXhours/不变
别忘了根据偏移量是正还是负来改变HTML代码，“In X hour(s)”或者“X hour(s) ago”
3，让我们更专业一点，允许/now/plus1hour/和/now/plus2hours/，但是不允许/now/plus1hours/和/now/plus2hour/
4，在HTML的显示里，如果偏移量是个位数，使用hour，否则使用hours
答案
1，hours_behind视图：
def hours_behind(request, offset):
offset = int(offset)
dt = datetime.datetime.now() - datetime.timedelta(hours=offset)
html = "%s hour(s) ago, it was %s." % (offset, dt)
return HttpResponse(html)
URL模式：
(r'^now/minus(\d{1,2})hours/$', hours_behind),
2，hour_offset视图：
def hour_offset(request, plus_or_minus, offset):
offset = int(offset)
if plus_or_minus == 'plus':
dt = datetime.datetime.now() + datetime.timedelta(hours=offset)
html = 'In %s hour(s), it will be %s.' % (offset, dt)
else:
dt = datetime.datetime.now() - datetime.timedelta(hours=offset)
html = '%s hour(s) ago, it was %s.' % (offset, dt)
html = '%s' % html
return HttpResponse(html)
URL模式：
(r'^now/(plus|minus)(\d{1,2})hours/$', hour_offset),
3，URL模式：
(r'^now/(plus|minus)(1)hour/$', hour_offset), (r'^now/(plus|minus)([2-9]|\d\d)hours/$', hour_offset),
其中“|”表示“or”，上面的模式表示匹配模式[2-9]或者\d\d
即匹配一个2到9的数字或者匹配两个数字
4，hour_offset视图：
def hour_offset(request, plus_or_minus, offset):
offset = int(offset)
if offset == 1:
hours = 'hour'
else:
hours = 'hours'
if plus_or_minus == 'plus':
dt = datetime.datetime.now() + datetime.timedelta(hours=offset)
output = 'In %s %s, it will be %s.' % (offset, hours, dt)
else:
dt = datetime.datetime.now() - datetime.timedelta(hours=offset)
output = '%s %s ago, it was %s.' % (offset, hours, dt)
output = '%s' % output
return HttpResponse(output)
难道不能把展现层代码从Python代码里分离出去吗？呵呵，这预示着......
您还没有登录,请您登录后再发表评论
1 楼 objectjava 2011-05-24 10:11