深入理解django的Urls分发

原文链接：http://www.cnblogs.com/BeginMan/p/3264097.html

目录索引：

一、Django URL的本质

二、解析patterns()函数

三、解析url()函数

四、include（）函数

五、url高级配置

 

一、本质

(1)：它的本质是 URL 模式以及要为该 URL 模式调用的视图函数之间的映射表。

django-admin.py startproject 运行时，该脚本会自动为你建了一份 URLconf(URL configuration)（即 urls.py 文件）。由于它是纯Python代码(pure Python code)，可以动态创建(Dynamically Constructed).

 

(2)：Django 把这个记录到ROOT_URLCONF 中

ROOT_URLCONF

Default: Not defined

自动创建的settings.py包含一个ROOT_URLCONF配置用来指向自动产生的urls.py. 打开文件settings.py你将看到如下：

ROOT_URLCONF = 'mysite.urls'

相对应的文件是mysite/urls.py

一个字符串代表完整的Python导入路径URLconf根，如’mydjangoapps.urls’,可以覆盖根据每条请求通过设置属性urlconf传入的HttpRequest对象。

 

(3)：当访问 URL /hello/ 时，Django 根据 ROOT_URLCONF 的设置装载 URLconf 。 然后按顺序逐个匹配URLconf里的URLpatterns，直到找到一个匹配的。 当找到这个匹配 的URLpatterns就调用相关联的view函数，并把 HttpRequest 对象作为第一个参数。

 

(4)：视图函数必须返回一个HttpResponse，Django转换HttpResponse为一个适合的HTTP response， 以Web page显示出来

 

二、patterns()函数

urlpatterns should be a Python list，in the format returned by the function patterns()

#django.conf.urls.defaults.patterns()django.conf.urls.defaults import *  #  import patterns()

patterns(prefix, pattern_description, ...)

The first arguement to patterns() is  a string prefix(前缀)

The remaining(剩余的) arguements should be tuples :

一般我们将patterns()函数返回的值保存到 urlpatterns变量中．

Once one of the regexes matches, Django imports and calls the given view, which is a simple Python function.

视图函数使用HttpRequest对象作为第一个参数，任何值捕获的正则表达式作为其他参数。

def myblog(request,id,name):    pass

 

三、url()函数

You can use the url() function, instead of a tuple, as an argument to patterns()

语法：

url(regex, view, kwargs=None, name=None, prefix='')

urlpatterns =patterns('djtest.views',     (r'^json/$','json'),     url(r'^geturl/$','geturls',name='get_urls'),                         )

 

#如果patterns()没有前缀的话，也可这样：urlpatterns += patterns('',    url(r'^geturl2/$','geturl2',name='geturl2_test',prefix='djtest.views'),)

 

四、include（）函数

include(<module or pattern_list>)

your urlpatterns can “include” other URLconf modules！

通常用于分类处理，使项目中urls高度统一．如：

urlpatterns +=patterns('',     (r'^blog/',include('myblog.urls')),        #myblog app 中urls     (r'^manage/',include('manager.urls')),     #manage app 中urls)

 

注意：

（１）、include() 的正则表达式并不包含一个 $ （字符串结尾匹配符），但是包含了一个斜杆／。

（２）、每当Django遇到 include() 时，它将截断匹配的URL，并把剩余的字符串发往包含的URLconf作进一步处理。

如在 myblog.app中urls如下：

#myblog.app 中的urlsurlpatterns =patterns('myblog.views',     (r'^index/$','index'),     #博客首页                   )

 

那么就讨论一下include()匹配的模式吧：

(1):不含变量参数

如在url输入框中输入 http://127.0.0.1:8000/blog/index/ 则，它会截取include()中匹配的url，这里是”blog” 接下来找到了宿主了也就是myblog.urls，那么剩余的部分 这里是”index” 去匹配myblog.urls中的url模式。

(2):含有变量参数(如命名组)

#root urlsurlpatterns += patterns('',   (r'^(?P<username>\w+)/blog/',include('blog.urls')),                        )#blog.urlsurlpatterns = patterns('blog.views',        (r'^index/$','index'),        (r'^other/$','other'),)#blog.viewsdef index(request):    return HttpResponse('ok')#参数变量处理def other(request,username):    return HttpResponse(username)

被捕获的 username 变量将传递给被包含的 URLconf，进而传递给那个URLconf中的 每一个 视图函数。

那么在浏览器输入：http://127.0.0.1:8000/BeginMan/blog/other/

则输出：BeginMan

更复杂点：

(r'^blog/(?P<username>\w+)/(?P<user_id>\d+)/',include('blog.urls'))    #.....def index(request,username,user_id):    return HttpResponse('ok:%s,%s' %(username,user_id))

 

输入：http://127.0.0.1:8000/blog/BeginMan/20/index/

输出：ok:BeginMan,20

注意 后面不要忘了去匹配blog urls的哪个urls。如(r'^index/$’)

 

五、url高级配置

参考：Django零碎知识(10):URL常用配置方法 [转载]

这里详解一下部分

1、命名组：

无命名 正则表达式组，即，在我们想要捕获的URL部分上加上小括号，Django 会将捕获的文本作为位置参数传递给视图函数。

命名 正则表达式组来捕获URL，并且将其作为 关键字 参数传给视图。

命名的正则表达式组的语法是:

（?P<name>pattern）

name:组名称

pattern:匹配的某个模式，常见有：

SymbolMatching.任意单个字符\d匹配任意数字[A-Z]匹配A-Z任意大写字母[a-z]匹配a-z任意小写字母[A-Za-z]匹配a-z任意字母不论大小写+匹配一个或多个 （如:\d+）[^xxx]+匹配一个或多个不为xxx的(如[^name]+)？匹配零个或一个(如：\d?)*匹配零个或更多(如：\d*){a,b}匹配介于a ,b之间（如：\d{1,3}一个或两个或三个数字）

 

实例如下：

('^position/(\d{4})/(\d{2})/$','position'),             #无命名 正则表达式组('^name/(?P<year>\d{4})/(?P<month>\d{2})/$','name'),    #命名组

则输入地址：http://127.0.0.1:8000/position/2013/15/、http://127.0.0.1:8000/name/2013/15/在相应视图函数中进行处理

#以位置参数的形式，如果位置改变，如(request,month,year)，则相应的值也会随之改变def position(request,year,month):    return HttpResponse('position:%s--%s' %(year,month))    #输出：position:2013--10    #关键字参数，key-value映射关系，与位置无关，所以当位置改变，值不变def name(request,month,year):    return HttpResponse('name:%s--%s' %(year,month))

 

2、传递额外的参数到视图函数中

URLconf里面的每一个模式都可以包含第三个数据： 一个关键字参数的字典。

('^foo/$','commonView',{'name':'foo','age':22}),('^bar/$','commonView',{'name':'bar','age':12}),

 

 

def commonView(request,name,age):    return HttpResponse('name:%s--age:%s' %(name,age))

则输入：http://127.0.0.1:8000/bar/、http://127.0.0.1:8000/foo/ 则输出： bar、 foo

常见应用是传递模板：

# urls.pyfrom django.conf.urls.defaults import *from mysite import viewsurlpatterns = patterns('',    (r'^foo/$', views.foobar_view, {'template_name': 'template1.html'}),    (r'^bar/$', views.foobar_view, {'template_name': 'template2.html'}),)# views.pyfrom django.shortcuts import render_to_responsefrom mysite.models import MyModeldef foobar_view(request, template_name):    m_list = MyModel.objects.filter(is_new=True)    return render_to_response(

template_name,

 {'m_list': m_list})