Django 之 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 中的urls
urlpatterns =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 urls
urlpatterns += patterns('',
   (r'^(?P<username>w+)/blog/',include('blog.urls')),                        
)

#blog.urls
urlpatterns = patterns('blog.views',
        (r'^index/$','index'),
        (r'^other/$','other'),
)

#blog.views
def 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:匹配的某个模式，常见有：

Symbol	Matching
.	任意单个字符
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.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})