当前位置:首页 > 网站旧栏目 > 学习园地 > 设计软件教程 > 翻译www.djangobook.com之第八章:高级视图和URL配置

翻译www.djangobook.com之第八章:高级视图和URL配置
2010-01-13 23:37:42  作者:  来源:
URL配置技巧
使方法import流化
看看下面的URL配置,基于第3章的例子:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2. from mysite.views import current_datetime, hours_ahead, hours_behind, now_in_chicago, now_in_london   
  3.   
  4. urlpatterns = patterns('',   
  5.     (r'^now/$', current_datetime),   
  6.     (r'^now/plus(\d{1,2})hours/$', hours_ahead),   
  7.     (r'^now/minus(\d{1,2})hours/$', hours_behind),   
  8.     (r'^now/in_chicago/$', now_in_chicago),   
  9.     (r'^now/in_london/$', now_in_london),   
  10. )  

前面第3章解释到,URL配置里每行都包含了它相关的视图方法,直接作为一个方法对象传递
这意味着有必要在模块最上面import视图方法
但是随着Django程序越来越复杂,它的URL配置也随之增加,维护这些imports将十分麻烦
对于每个新的视图方法,你都要记得import它,并且使用这个方法的话import语句会变得很长
可以通过import views模块本身来避免这种复杂,下面的URL配置的例子和上面的是相等的:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2. from mysite import views   
  3.   
  4. urlpatterns = patterns('',   
  5.     (r'^now/$', views.current_datetime),   
  6.     (r'^now/plus(\d{1,2})hours/$', views.hours_ahead),   
  7.     (r'^now/minus(\d{1,2})hours/$', views.hours_behind),   
  8.     (r'^now/in_chicago/$', views.now_in_chicago),   
  9.     (r'^now/in_london/$', views.now_in_london),   
  10. )  

Django提供另一种方式来在URL配置中指定视图方法:你可以传递一个包含模块名字和方法名字的字符串
而不是方法对象本身,继续上面的例子:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2.   
  3. urlpatterns = patterns('',   
  4.     (r'^now/$''mysite.views.current_datetime'),   
  5.     (r'^now/plus(\d{1,2})hours/$''mysite.views.hours_ahead'),   
  6.     (r'^now/minus(\d{1,2})hours/$''mysite.views.hours_behind'),   
  7.     (r'^now/in_chicago/$''mysite.views.now_in_chicago'),   
  8.     (r'^now/in_london/$''mysite.views.now_in_london'),   
  9. )  

使用这种技术,没有必要再import视图方法,Django根据字符串描述的视图方法的名字和路径自动
在第一次访问时import合适的视图方法
另一种捷径是当使用字符创技术时可以把通用的视图前缀提取出来,我们的例子中,每个视图字符串
都以'mysite.views'开始,它们是冗余的,我们可以把它作为第一个参数传递给patterns():
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2.   
  3. urlpatterns = patterns('mysite.views',   
  4.     (r'^now/$''current_datetime'),   
  5.     (r'^now/plus(\d{1,2})hours/$''hours_ahead'),   
  6.     (r'^now/minus(\d{1,2})hours/$''hours_behind'),   
  7.     (r'^now/in_chicago/$''now_in_chicago'),   
  8.     (r'^now/in_london/$''now_in_london'),   
  9. )  

注意你不需在前缀末尾加上".",也不需在视图字符串前面加".",Django会自动加上去
这两种方式哪种更好?这取决于你的个人编码风格和需求
使用字符串方式的优点:
1,更紧凑,因为不需要import视图方法
2,如果你的视图方法分布在几个不同的Python模块,这种方式更可读和更易管理
使用方法对象方式的优点:
1,可以轻松包装视图方法,参考本章后面的“包装视图方法”
2,更“Pythonic”,更贴近Python传统,如传递方法对象
两种方式都是合法的,你甚至可以在同一URL配置里混用它们,选择权在你手中

多种视图前缀
实践中如果你使用字符串技术,你很可能混合视图,因为视图没有通用的前缀
尽管如此,你可以利用视图前缀捷径来减少冗余,只需将多个patterns()加到一起
旧的:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2.   
  3. urlpatterns = patterns('',   
  4.     (r'^/?$''mysite.views.archive_index'),   
  5.     (r'^(\d{4})/([a-z]{3})/$''mysite.views.archive_month'),   
  6.     (r'^tag/(\w+)/$''weblog.views.tag'),   
  7. )  

新的:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2.   
  3. urlpatterns = patterns('mysite.views',   
  4.     (r'^/?$''archive_index'),   
  5.     (r'^(\d{4})/([a-z]{3})/$','archive_month'),   
  6. )   
  7.   
  8. urlpatterns += patterns('weblog.views',   
  9.     (r'^tag/(\w+)/$''tag'),   
  10. )  

Django只关心是否有一个模块级的变量urlpatterns,而这个变量可以被动态构建,像上面的例子一样

命名组
到目前为止在我们所有的URL配置的例子中,我们使用了简单的,未命名的正则表达式组
即我们用括号包括我们想捕获的部分URL,Django像传递位置参数一样把这些捕获的文本传递给视图方法
在更高级的使用中,可以使用命名的正则表达式组来捕获URL并且传递关键字参数给视图
关键字参数与位置参数
一个Python方法可以使用关键字参数或者位置参数来调用,它们是一样的
在关键字参数调用中,你指定你想传递的参数名和值
在位置参数调用中,你简单的传递参数而不指定哪个参数匹配哪个值,关联在参数顺序中隐含
看看下面这个简单的方法:
Java代码 复制代码
  1. def sell(item, price, quantity):   
  2.     print "Selling %s unit(s) of %s at %s" % (quantity, item, price)  

你可以按方法定义的参数顺序传递参数来使用位置参数调用:sell('Socks', '$2.50', 6)
你也可以指定参数名和参数值来使用关键字参数调用,下面的语句是相等的:
Java代码 复制代码
  1. sell(item='Socks', price='$2.50', quantity=6)   
  2. sell(item='Socks', quantity=6, price='$2.50')   
  3. sell(price='$2.50', item='Socks', quantity=6)   
  4. sell(price='$2.50', quantity=6, item='Socks')   
  5. sell(quantity=6, item='Socks', price='$2.50')   
  6. sell(quantity=6, price='$2.50', item='Socks')  

在Python正则表达式中,命名组的语法是(?P<name>pattern),其中name是组的名字,pattern是要匹配的模式
下面是URL配置的使用未命名组的例子:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2. from mysite import views   
  3.   
  4. urlpatterns = patterns('',   
  5.     (r'^articles/(\d{4})/$', views.year_archive),   
  6.     (r'^articles/(\d{4})/(\d{2})/$', views.month_archive),   
  7. )  

这里我们使用同样的URL配置,但是使用命名组来重写:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2. from mysite import views   
  3.   
  4. urlpatterns = patterns('',   
  5.     (r'^articles/(?P<year>\d{4})/$', views.year_archive),   
  6.     (r'^articles/(?P<year>\d{4})/(?P<month>\d{2})/$', views.month_archive),   
  7. )  

下面的例子和上面的例子达到的是同样的目的,但是有一个微小的差别,它捕获的值传递给视图方法时
使用的是关键字参数而不是位置参数
例如,使用未命名组,对/articles/2006/03的访问将导致下面的方法调用:
month_archive(request, '2006', '03')
使用命名组,同样的请求则会导致下面的方法调用:
month_archive(request, year='2006', month='03')
实践中使用命名组会让你的URL配置更清晰和带来更少的参数顺序bugs,而且你可以重排视图方法中
定义的参数的顺序
按照上面的例子,如果你想改变URL使month在year的前面,并且我们使用未命名组,我们必须记得去改
month_archive视图的参数顺序,而如果我们使用命名组,在URL中改变捕获的参数的顺序不会对视图造成影响
当然,命名组的好处也带来一些简洁上的代价,一些开发人员认为命名组的语法丑陋而且冗长

匹配和组算法
如果你同时命名组和未命名组使用两种方式来处理相同的URL模式,你应该清楚Django怎样处理这种特殊情况
下面是URL配置解析器的算法:
1,如果有命名的参数,Django将使用它,并且忽略未命名的参数
2,否则,Django视所有的未命名参数为位置参数传递
3,两种参数都有的情况下,Django将传递一些额外的关键字参数作为关键字参数
参考下面的“向视图方法传递额外选项”

向视图方法传递额外选项
有时候你发现你些的视图方法很相似,只有一些很少的差别
例如,你有两个视图,它们的内容除了使用的模板不同其它都一样:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4. from mysite import views   
  5.   
  6. urlpatterns = patterns('',   
  7.     (r'^foo/$', views.foo_view),   
  8.     (r'^bar/$', views.bar_view),   
  9. )   
  10.   
  11. # views.py   
  12.   
  13. from django.shortcuts import render_to_response   
  14. from mysite.models import MyModel   
  15.   
  16. def foo_view(request):   
  17.     m_list = MyModel.objects.filter(is_new=True)   
  18.     return render_to_response('template1.html', {'m_list': m_list})   
  19.   
  20. def bar_view(request):   
  21.     m_list = MyModel.objects.filter(is_new=True)   
  22.     return render_to_response('template2.html', {'m_list': m_list})  

我们在重复我们自己,这是不优雅的
首先你可能想通过使用同样的视图处理两种URL来减少冗余,用括号括住URL来捕获它,并且在视图里
通过URL检查来决定模板:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4. from mysite import views   
  5.   
  6. urlpatterns = patterns('',   
  7.     (r'^(foo)/$', views.foobar_view),   
  8.     (r'^(bar)/$', views.foobar_view),   
  9. )   
  10.   
  11. # views.py   
  12.   
  13. from django.shortcuts import render_to_response   
  14. from mysite.models import MyModel   
  15.   
  16. def foobar_view(request, url):   
  17.     m_list = MyModel.objects.filter(is_new=True)   
  18.     if url == 'foo':   
  19.         template_name = 'template1.html'  
  20.     elif url == 'bar':   
  21.         template_name = 'template2.html'  
  22.     return render_to_response(template_name, {'m_list': m_list})  

这种方案的问题是它吧URL和你的代码耦合在了一起,如果你想把/foo/改名为/fooey/,你必须记得去
更改视图代码
优雅的方式涉及到一个交额外URL配置选项的特性,URL配置中每个模式可能包含了另外一项:一个关键字
参数的字典,它将被传递到视图方法中
我们可以像下面这样重写我们的例子:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4. from mysite import views   
  5.   
  6. urlpatterns = patterns('',   
  7.     (r'^foo/$', views.foobar_view, {'template_name''template1.html'}),   
  8.     (r'^bar/$', views.foobar_view, {'template_name''template2.html'}),   
  9. )   
  10.   
  11. # views.py   
  12.   
  13. from django.shortcuts import render_to_response   
  14. from mysite.models import MyModel   
  15.   
  16. def foobar_view(request, template_name):   
  17.     m_list = MyModel.objects.filter(is_new=True)   
  18.     return render_to_response(template_name, {'m_list': m_list})  

你可以看到,例子中URL配置指定了template_name,视图方法只是把它当作另一个参数
额外URL配置选项技术是向视图方法传递额外的信息的很好的方式,它在Django绑定的一些
程序中用到,尤其是我们将在第9章碰到的generic views系统
下面是关于怎样使用额外URL配置选项技术的一些方法

伪造捕获的URL配置值
假设你已经有一些匹配模式的视图,但是还有一个URL使用同样的视图逻辑却和模式不匹配
这种情况下你可以通过额外URL配置选项伪造捕获的URL值来处理具有相同视图的额外的URL
例如,你可能有一个从特殊日期显示数据的程序,像下面的URL:
Java代码 复制代码
  1. /mydata/jan/01/   
  2. /mydata/jan/02/   
  3. /mydata/jan/03/   
  4. # ...   
  5. /mydata/dec/30/   
  6. /mydata/dec/31/  

这很简单就可以处理,你可以像下面这样捕获URL(使用命名组语法):
Java代码 复制代码
  1. urlpatterns = patterns('',   
  2.     (r'^mydata/(?P<month>\w{3})/(?P<day>\d\d)/$', views.my_view),   
  3. )  

视图方法可能是这样:
Java代码 复制代码
  1. def my_view(request, month, day):   
  2.     # ....  

这非常直接,没有我们没遇到过的,当你像增加另一个使用my_view的URL并且这个URL不包括month
或day的时候,技巧就出现了
例如你想增加另一个URL /mydata/birthday/,而它应该等同与/mydata/jan/06,我们可以像下面这样
利用额外URL配置选项:
Java代码 复制代码
  1. urlpatterns = patterns('',   
  2.     (r'^mydata/birthday/$', views.my_view, {'month''jan''day''06'}),   
  3.     (r'^mydata/(?P<month>\w{3})/(?P<day>\d\d)/$', views.my_view),   
  4. )  

这里很酷的地方是,我们根本不需要改变我们的视图方法,视图方法仅仅关心它可以得到month和day参数
它不关心这些参数是否来自于URL捕获本身或者额外参数

让视图一般化
在代码中提取公共部分是很好的编程实践,例如我们有下面两个Python方法:
Java代码 复制代码
  1. def say_hello(person_name):   
  2.     print 'Hello, %s' % person_name   
  3.   
  4. def say_goodbye(person_name):   
  5.     print 'Goodbye, %s' % person_name  

我们可以把问候语提取出来让它成为一个参数:
Java代码 复制代码
  1. def greet(person_name, greeting):   
  2.     print '%s, %s' % (greeting, person_name)  

你可以通过使用额外URL配置参数把这个哲学应用到你的Django视图中去
这样你就可以创建高级抽象视图,例如:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4. from mysite import views   
  5.   
  6. urlpatterns = patterns('',   
  7.     (r'^events/$', views.event_list),   
  8.     (r'^blog/entries/$', views.entry_list),   
  9. )   
  10.   
  11. # views.py   
  12.   
  13. from django.shortcuts import render_to_response   
  14. from mysite.models import Event, BlogEntry   
  15.   
  16. def event_list(request):   
  17.     obj_list = Event.objects.all()   
  18.     return render_to_response('mysite/event_list.html', {'event_list': obj_list})   
  19.   
  20. def entry_list(request):   
  21.     obj_list = BlogEntry.objects.all()   
  22.     return render_to_response('mysite/blogentry_list.html', {'entry_list': obj_list})  

两个视图做的是同一件事情,它们都负责显示对象列表,因此让我们把要显示的对象的类型抽象出来:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4. from mysite import models, views   
  5.   
  6. urlpatterns = patterns('',   
  7.     (r'^events/$', views.object_list, {'model': models.Event}),   
  8.     (r'^blog/entries/$', views.object_list, {'model': models.BlogEntry}),   
  9. )   
  10.   
  11. # views.py   
  12.   
  13. from django.shortcuts import render_to_response   
  14.   
  15. def object_list(request, model):   
  16.     obj_list = model.objects.all()   
  17.     template_name = 'mysite/%s_list.html' % model.__name__.lower()   
  18.     return render_to_response(template_name, {'object_list': obj_list})  

通过这些小改动,我们突然就有了一个可重用的,模型不可知的视图!
从现在开始,任何时候我们需要一个对象列表的视图,我们都可以简单的重用object_list视图
而不是写视图代码,下面是关于我们做的事情的注意:
1,我们直接传递模型类作为model参数,额外URL配置选项字典可以传递任何类型的Python对象
2,model.objects.all()这一行是一个鸭子类型:“如果它走起来像鸭子,说话像鸭子,我们就认为
它是一只鸭子”,注意代码并不知道model是什么类型,唯一的前提是model有一个objects属性
并且objects有一个all()方法
3,我们使用model.__name__.lower()来决定模板名,每个Python类都有__name__属性,它返回类名
这个特性对于现在的情形特别有用,我们直到运行时才知道类的类型
4,这个例子和上一个例子的一点不同是,我们传递通用的变量名object_list到模板中
我们可以很容易改变这个变量名为blogentry_list或者event_list,我们把这个工作留给读者作为练习
因为数据库驱动的Web站点有许多通用的模式,Django带来了使用额外技术的“generic views”来为你
节省时间,我们将在下一章讲到Django内建的generic views

给予视图配置选项
如果你发布一个Django程序,你的用户可能想拥有一定程度上的配置
这种情况下,向你的视图添加钩子来应对人们可能需要一些配置选项是个好注意
你可以使用额外URL配置参数来达到这个目的
程序中一个常见的配置是模板名:
Java代码 复制代码
  1. def my_view(request, template_name):   
  2.     var = do_something()   
  3.     return render_to_response(template_name, {'var': var})  


捕获值的优先级与额外选项
当有冲突时,额外URL配置参数要比捕获的参数优先级高
换句话说,如果你的URL配置捕获了一个命名组变量和一个额外URL配置参数,而它们的变量名相同
则额外URL配置参数值将被使用,例如下面的URL配置:
Java代码 复制代码
  1. from django.conf.urls.defaults import *   
  2.   
  3. urlpatterns = patterns('',   
  4.     (r'^mydata/(?P<id>\d+)/$', views.my_view, {'id'3}),   
  5. )  

在这里正则表达式和额外的字典都包含id参数,此时硬编码的id具有更高的优先级
这意味着/mydata/2/或者/mydata/432432/将被当成id设为3看待,而不管URL所捕获的值
敏锐的读者可能注意到这种情况下,在正则表达式里面捕获id是纯粹在浪费时间
因为它的值一直会被字典的值覆盖
这些敏锐的读者是正确的,我们讲这些内容只是想帮助你避免错误

使用默认视图参数
另外一个方便的技巧是指定视图的默认参数,它告诉视图如果一个参数值是none则使用默认值,例如:
Java代码 复制代码
  1. # urls.py   
  2.   
  3. from django.conf.urls.defaults import *   
  4.   
  5. urlpatterns = patterns('',   
  6.     (r'^blog/$', views.page),   
  7.     (r'^blog/page(?P<num>\d+)/$', views.page),   
  8. )   
  9.   
  10. # views.py   
  11.   
  12. def page(request, num="1"):   
  13.     # Output the appropriate page of blog entries, according to num.   
  14.     # ...  

这里两个URL模式指向了同一个视图views.page,但是第一个模式不会从URL捕获任何东西
如果第一个模式匹配了,page()方法讲使用num的默认参数“1”,如果第二个模式匹配了
page()讲使用正则表达式捕获的num值
和配置选项一起使用这个技术很常见,下面的例子对给予视图配置选项的例子做了小小改进:
Java代码 复制代码
  1. def my_view(request, template_name='mysite/my_view.html'):   
  2.     var = do_something()   
  3.     return render_to_response(template_name, {'var': var})  


特殊情况下的视图
有时候你在URL配置里有一个处理很多URL的模式但是你需要特别指出其中一个
这种情况下,使用URL配置中把特殊情况放在首位的线性处理方式
例如,Django的admin站点中“添加对象”页面是如下配置的:
Java代码 复制代码
  1. urlpatterns = patterns('',   
  2.     # ...   
  3.     ('^([^/]+)/([^/]+)/add/$''django.contrib.admin.views.main.add_stage'),   
  4.     # ...   
  5. )  

这将匹配像/myblog/entries/add/和/auth/groups/add/这样的URL
尽管如此,对于用户对象的添加页面/auth/user/add/是个特殊情况,例如它不会显示所有的表单域,
它显示两个密码域等等,我们可以通过在视图中特别指出来以解决这个问题:
Java代码 复制代码
  1. def add_stage(request, app_label, model_name):   
  2.     if app_label == 'auth' and model_name == 'user':   
  3.         # do special-case code   
  4.     else:   
  5.         # do normal code  

但是它并不优雅,因为它把URL逻辑放在视图中,更优雅的方式是我们利用URL配置是从顶向下解析的方案:
Java代码 复制代码
  1. urlpatterns = patterns('',   
  2.     # ...   
  3.     ('^auth/user/add/$''django.contrib.admin.views.auth.user_add_stage'),   
  4.     ('^([^/]+)/([^/]+)/add/$''django.contrib.admin.views.main.add_stage'),   
  5.     # ...   
  6. )  

这样的话对于/auth/user/add/的请求将会被user_add_stage视图处理,尽管URL也匹配第二种模式
它会先匹配上面的模式(这是短路逻辑)

从URL捕获文本的注意点
每个被捕获的参数像普通的Python字符串一样被传递给视图,而不管正则表达式匹配的类型
例如,下面的URL配置: