使方法import流化
看看下面的URL配置,基于第3章的例子:
- from django.conf.urls.defaults import *
- from mysite.views import current_datetime, hours_ahead, hours_behind, now_in_chicago, now_in_london
- urlpatterns = patterns('',
- (r'^now/$', current_datetime),
- (r'^now/plus(\d{1,2})hours/$', hours_ahead),
- (r'^now/minus(\d{1,2})hours/$', hours_behind),
- (r'^now/in_chicago/$', now_in_chicago),
- (r'^now/in_london/$', now_in_london),
- )
前面第3章解释到,URL配置里每行都包含了它相关的视图方法,直接作为一个方法对象传递
这意味着有必要在模块最上面import视图方法
但是随着Django程序越来越复杂,它的URL配置也随之增加,维护这些imports将十分麻烦
对于每个新的视图方法,你都要记得import它,并且使用这个方法的话import语句会变得很长
可以通过import views模块本身来避免这种复杂,下面的URL配置的例子和上面的是相等的:
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^now/$', views.current_datetime),
- (r'^now/plus(\d{1,2})hours/$', views.hours_ahead),
- (r'^now/minus(\d{1,2})hours/$', views.hours_behind),
- (r'^now/in_chicago/$', views.now_in_chicago),
- (r'^now/in_london/$', views.now_in_london),
- )
Django提供另一种方式来在URL配置中指定视图方法:你可以传递一个包含模块名字和方法名字的字符串
而不是方法对象本身,继续上面的例子:
- from django.conf.urls.defaults import *
- urlpatterns = patterns('',
- (r'^now/$', 'mysite.views.current_datetime'),
- (r'^now/plus(\d{1,2})hours/$', 'mysite.views.hours_ahead'),
- (r'^now/minus(\d{1,2})hours/$', 'mysite.views.hours_behind'),
- (r'^now/in_chicago/$', 'mysite.views.now_in_chicago'),
- (r'^now/in_london/$', 'mysite.views.now_in_london'),
- )
使用这种技术,没有必要再import视图方法,Django根据字符串描述的视图方法的名字和路径自动
在第一次访问时import合适的视图方法
另一种捷径是当使用字符创技术时可以把通用的视图前缀提取出来,我们的例子中,每个视图字符串
都以'mysite.views'开始,它们是冗余的,我们可以把它作为第一个参数传递给patterns():
- from django.conf.urls.defaults import *
- urlpatterns = patterns('mysite.views',
- (r'^now/$', 'current_datetime'),
- (r'^now/plus(\d{1,2})hours/$', 'hours_ahead'),
- (r'^now/minus(\d{1,2})hours/$', 'hours_behind'),
- (r'^now/in_chicago/$', 'now_in_chicago'),
- (r'^now/in_london/$', 'now_in_london'),
- )
注意你不需在前缀末尾加上".",也不需在视图字符串前面加".",Django会自动加上去
这两种方式哪种更好?这取决于你的个人编码风格和需求
使用字符串方式的优点:
1,更紧凑,因为不需要import视图方法
2,如果你的视图方法分布在几个不同的Python模块,这种方式更可读和更易管理
使用方法对象方式的优点:
1,可以轻松包装视图方法,参考本章后面的“包装视图方法”
2,更“Pythonic”,更贴近Python传统,如传递方法对象
两种方式都是合法的,你甚至可以在同一URL配置里混用它们,选择权在你手中
多种视图前缀
实践中如果你使用字符串技术,你很可能混合视图,因为视图没有通用的前缀
尽管如此,你可以利用视图前缀捷径来减少冗余,只需将多个patterns()加到一起
旧的:
- from django.conf.urls.defaults import *
- urlpatterns = patterns('',
- (r'^/?$', 'mysite.views.archive_index'),
- (r'^(\d{4})/([a-z]{3})/$', 'mysite.views.archive_month'),
- (r'^tag/(\w+)/$', 'weblog.views.tag'),
- )
新的:
- from django.conf.urls.defaults import *
- urlpatterns = patterns('mysite.views',
- (r'^/?$', 'archive_index'),
- (r'^(\d{4})/([a-z]{3})/$','archive_month'),
- )
- urlpatterns += patterns('weblog.views',
- (r'^tag/(\w+)/$', 'tag'),
- )
Django只关心是否有一个模块级的变量urlpatterns,而这个变量可以被动态构建,像上面的例子一样
命名组
到目前为止在我们所有的URL配置的例子中,我们使用了简单的,未命名的正则表达式组
即我们用括号包括我们想捕获的部分URL,Django像传递位置参数一样把这些捕获的文本传递给视图方法
在更高级的使用中,可以使用命名的正则表达式组来捕获URL并且传递关键字参数给视图
关键字参数与位置参数
一个Python方法可以使用关键字参数或者位置参数来调用,它们是一样的
在关键字参数调用中,你指定你想传递的参数名和值
在位置参数调用中,你简单的传递参数而不指定哪个参数匹配哪个值,关联在参数顺序中隐含
看看下面这个简单的方法:
- def sell(item, price, quantity):
- print "Selling %s unit(s) of %s at %s" % (quantity, item, price)
你可以按方法定义的参数顺序传递参数来使用位置参数调用:sell('Socks', '$2.50', 6)
你也可以指定参数名和参数值来使用关键字参数调用,下面的语句是相等的:
- sell(item='Socks', price='$2.50', quantity=6)
- sell(item='Socks', quantity=6, price='$2.50')
- sell(price='$2.50', item='Socks', quantity=6)
- sell(price='$2.50', quantity=6, item='Socks')
- sell(quantity=6, item='Socks', price='$2.50')
- sell(quantity=6, price='$2.50', item='Socks')
在Python正则表达式中,命名组的语法是(?P<name>pattern),其中name是组的名字,pattern是要匹配的模式
下面是URL配置的使用未命名组的例子:
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^articles/(\d{4})/$', views.year_archive),
- (r'^articles/(\d{4})/(\d{2})/$', views.month_archive),
- )
这里我们使用同样的URL配置,但是使用命名组来重写:
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^articles/(?P<year>\d{4})/$', views.year_archive),
- (r'^articles/(?P<year>\d{4})/(?P<month>\d{2})/$', views.month_archive),
- )
下面的例子和上面的例子达到的是同样的目的,但是有一个微小的差别,它捕获的值传递给视图方法时
使用的是关键字参数而不是位置参数
例如,使用未命名组,对/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将传递一些额外的关键字参数作为关键字参数
参考下面的“向视图方法传递额外选项”
向视图方法传递额外选项
有时候你发现你些的视图方法很相似,只有一些很少的差别
例如,你有两个视图,它们的内容除了使用的模板不同其它都一样:
- # urls.py
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^foo/$', views.foo_view),
- (r'^bar/$', views.bar_view),
- )
- # views.py
- from django.shortcuts import render_to_response
- from mysite.models import MyModel
- def foo_view(request):
- m_list = MyModel.objects.filter(is_new=True)
- return render_to_response('template1.html', {'m_list': m_list})
- def bar_view(request):
- m_list = MyModel.objects.filter(is_new=True)
- return render_to_response('template2.html', {'m_list': m_list})
我们在重复我们自己,这是不优雅的
首先你可能想通过使用同样的视图处理两种URL来减少冗余,用括号括住URL来捕获它,并且在视图里
通过URL检查来决定模板:
- # urls.py
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^(foo)/$', views.foobar_view),
- (r'^(bar)/$', views.foobar_view),
- )
- # views.py
- from django.shortcuts import render_to_response
- from mysite.models import MyModel
- def foobar_view(request, url):
- m_list = MyModel.objects.filter(is_new=True)
- if url == 'foo':
- template_name = 'template1.html'
- elif url == 'bar':
- template_name = 'template2.html'
- return render_to_response(template_name, {'m_list': m_list})
这种方案的问题是它吧URL和你的代码耦合在了一起,如果你想把/foo/改名为/fooey/,你必须记得去
更改视图代码
优雅的方式涉及到一个交额外URL配置选项的特性,URL配置中每个模式可能包含了另外一项:一个关键字
参数的字典,它将被传递到视图方法中
我们可以像下面这样重写我们的例子:
- # urls.py
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^foo/$', views.foobar_view, {'template_name': 'template1.html'}),
- (r'^bar/$', views.foobar_view, {'template_name': 'template2.html'}),
- )
- # views.py
- from django.shortcuts import render_to_response
- from mysite.models import MyModel
- def foobar_view(request, template_name):
- m_list = MyModel.objects.filter(is_new=True)
- 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:
- /mydata/jan/01/
- /mydata/jan/02/
- /mydata/jan/03/
- # ...
- /mydata/dec/30/
- /mydata/dec/31/
这很简单就可以处理,你可以像下面这样捕获URL(使用命名组语法):
- urlpatterns = patterns('',
- (r'^mydata/(?P<month>\w{3})/(?P<day>\d\d)/$', views.my_view),
- )
视图方法可能是这样:
- def my_view(request, month, day):
- # ....
这非常直接,没有我们没遇到过的,当你像增加另一个使用my_view的URL并且这个URL不包括month
或day的时候,技巧就出现了
例如你想增加另一个URL /mydata/birthday/,而它应该等同与/mydata/jan/06,我们可以像下面这样
利用额外URL配置选项:
- urlpatterns = patterns('',
- (r'^mydata/birthday/$', views.my_view, {'month': 'jan', 'day': '06'}),
- (r'^mydata/(?P<month>\w{3})/(?P<day>\d\d)/$', views.my_view),
- )
这里很酷的地方是,我们根本不需要改变我们的视图方法,视图方法仅仅关心它可以得到month和day参数
它不关心这些参数是否来自于URL捕获本身或者额外参数
让视图一般化
在代码中提取公共部分是很好的编程实践,例如我们有下面两个Python方法:
- def say_hello(person_name):
- print 'Hello, %s' % person_name
- def say_goodbye(person_name):
- print 'Goodbye, %s' % person_name
我们可以把问候语提取出来让它成为一个参数:
- def greet(person_name, greeting):
- print '%s, %s' % (greeting, person_name)
你可以通过使用额外URL配置参数把这个哲学应用到你的Django视图中去
这样你就可以创建高级抽象视图,例如:
- # urls.py
- from django.conf.urls.defaults import *
- from mysite import views
- urlpatterns = patterns('',
- (r'^events/$', views.event_list),
- (r'^blog/entries/$', views.entry_list),
- )
- # views.py
- from django.shortcuts import render_to_response
- from mysite.models import Event, BlogEntry
- def event_list(request):
- obj_list = Event.objects.all()
- return render_to_response('mysite/event_list.html', {'event_list': obj_list})
- def entry_list(request):
- obj_list = BlogEntry.objects.all()
- return render_to_response('mysite/blogentry_list.html', {'entry_list': obj_list})
两个视图做的是同一件事情,它们都负责显示对象列表,因此让我们把要显示的对象的类型抽象出来:
- # urls.py
- from django.conf.urls.defaults import *
- from mysite import models, views
- urlpatterns = patterns('',
- (r'^events/$', views.object_list, {'model': models.Event}),
- (r'^blog/entries/$', views.object_list, {'model': models.BlogEntry}),
- )
- # views.py
- from django.shortcuts import render_to_response
- def object_list(request, model):
- obj_list = model.objects.all()
- template_name = 'mysite/%s_list.html' % model.__name__.lower()
- 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配置参数来达到这个目的
程序中一个常见的配置是模板名:
- def my_view(request, template_name):
- var = do_something()
- return render_to_response(template_name, {'var': var})
捕获值的优先级与额外选项
当有冲突时,额外URL配置参数要比捕获的参数优先级高
换句话说,如果你的URL配置捕获了一个命名组变量和一个额外URL配置参数,而它们的变量名相同
则额外URL配置参数值将被使用,例如下面的URL配置:
- from django.conf.urls.defaults import *
- urlpatterns = patterns('',
- (r'^mydata/(?P<id>\d+)/$', views.my_view, {'id': 3}),
- )
在这里正则表达式和额外的字典都包含id参数,此时硬编码的id具有更高的优先级
这意味着/mydata/2/或者/mydata/432432/将被当成id设为3看待,而不管URL所捕获的值
敏锐的读者可能注意到这种情况下,在正则表达式里面捕获id是纯粹在浪费时间
因为它的值一直会被字典的值覆盖
这些敏锐的读者是正确的,我们讲这些内容只是想帮助你避免错误
使用默认视图参数
另外一个方便的技巧是指定视图的默认参数,它告诉视图如果一个参数值是none则使用默认值,例如:
- # urls.py
- from django.conf.urls.defaults import *
- urlpatterns = patterns('',
- (r'^blog/$', views.page),
- (r'^blog/page(?P<num>\d+)/$', views.page),
- )
- # views.py
- def page(request, num="1"):
- # Output the appropriate page of blog entries, according to num.
- # ...
这里两个URL模式指向了同一个视图views.page,但是第一个模式不会从URL捕获任何东西
如果第一个模式匹配了,page()方法讲使用num的默认参数“1”,如果第二个模式匹配了
page()讲使用正则表达式捕获的num值
和配置选项一起使用这个技术很常见,下面的例子对给予视图配置选项的例子做了小小改进:
- def my_view(request, template_name='mysite/my_view.html'):
- var = do_something()
- return render_to_response(template_name, {'var': var})
特殊情况下的视图
有时候你在URL配置里有一个处理很多URL的模式但是你需要特别指出其中一个
这种情况下,使用URL配置中把特殊情况放在首位的线性处理方式
例如,Django的admin站点中“添加对象”页面是如下配置的:
- urlpatterns = patterns('',
- # ...
- ('^([^/]+)/([^/]+)/add/$', 'django.contrib.admin.views.main.add_stage'),
- # ...
- )
这将匹配像/myblog/entries/add/和/auth/groups/add/这样的URL
尽管如此,对于用户对象的添加页面/auth/user/add/是个特殊情况,例如它不会显示所有的表单域,
它显示两个密码域等等,我们可以通过在视图中特别指出来以解决这个问题:
- def add_stage(request, app_label, model_name):
- if app_label == 'auth' and model_name == 'user':
- # do special-case code
- else:
- # do normal code
但是它并不优雅,因为它把URL逻辑放在视图中,更优雅的方式是我们利用URL配置是从顶向下解析的方案:
- urlpatterns = patterns('',
- # ...
- ('^auth/user/add/$', 'django.contrib.admin.views.auth.user_add_stage'),
- ('^([^/]+)/([^/]+)/add/$', 'django.contrib.admin.views.main.add_stage'),
- # ...
- )
这样的话对于/auth/user/add/的请求将会被user_add_stage视图处理,尽管URL也匹配第二种模式
它会先匹配上面的模式(这是短路逻辑)
从URL捕获文本的注意点
每个被捕获的参数像普通的Python字符串一样被传递给视图,而不管正则表达式匹配的类型
例如,下面的URL配置: