对于高质量的Web 应用来说,使用简洁、优雅的URL 模式是一个非常值得重视的细节。Django 让你随心所欲设计你的URL,不受框架束缚。
不要求有.php 或.cgi,更不会要求类似0,2097,1-1-1928,00 这样无意义的东西。
参见万维网的发明者Berners-Lee 的Cool URIs don’t change,里面有关于为什么URL 应该保持整洁和有意义的卓越论证。
概览¶
为了给一个应用设计URL,你需要创建一个Python模块,通常称为路由选择模块或路由解析模块URLconf(URL configuration)。该模块是一个纯粹的Python模块,是URL模式(简单的正则表达式)到Python 函数(你的视图)之间的简单映射。
根据你的需要,这个映射可短可长。它也可以引用其它的映射。而且,由于它是纯粹的Python 代码,所以可以被动态地构造。
Django 还提供了一种方式来根据当前活跃的语言对URL进行翻译。更多信息参见国际化文档。
Django 如何处理一个请求¶
当用户请求Django 站点上的某个页面时,django系统用一个算法来决定执行哪段Python代码:
首先,Django会使用路由解析根模块(root URLconf)来解析路由。通常,该路由解析根模块的位置由settings中的ROOT_URLCONF 变量指定(该模块的默认位置在BASE_DIR所指定的目录下的主app目录下的urls.py模块)。但是,如果进来的HttpRequest 对象有urlconf 属性(该属性由中间件request processing 设置),那么由ROOT_URLCONF所设置的路由解析根模块的路径则被HttpRequest对象的urlconf属性的值所替换。
Django 加载该路由解析模块,并寻找可用的urlpatterns。这个urlpattens是一个Python列表,该列表的每个元素都是django.conf.urls.url()的一个实例。
Django 依次匹配该列表中的每个URL模式,在遇到第一个与请求的URL相匹配的模式时停下来。
一旦某个正则表达式与请求的URL相匹配,则Django 导入并调用给定的视图,该视图仅为一个单纯的Python 函数(或者是一个基于类的视图)。同时,如下参数被传递给该视图:
如果所匹配的正则表达式返回的是若干个无名组,那么该正则表达式所匹配的内容将被作为位置参数提供给该视图。
关键字参数由与正则表达式相匹配的命名组组成,并且这些关键字参数可以被django.conf.urls.url()的可选参数kwargs覆盖。
如果请求的URL没有匹配到任何一个正则表达式,或者在匹配过程的任何时刻抛出了一个异常,那么Django 将调用适当的错误处理视图进行处理。请参见下面的错误处理。
例子¶
下面是一个简单的路由选择模块(URLconf)的示例:
from django.conf.urls import url
from . import views
urlpatterns = [
url(r'^articles/2003/$', views.special_case_2003),
url(r'^articles/([0-9]{4})/$', views.year_archive),
url(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),
url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail),
]
注:
若要从URL 中捕获某个值,只需要在它周围放置一对圆括号。
在正则表达式中不需要添加一个前导的反斜杠,因为每个URL默认都带有该符号。例如,应该写成^articles 而不是 ^/articles。
每个正则表达式前面的'r' 是可选的,但是建议加上。它告诉Python 这个字符串是“原始的” —— 字符串中任何字符都不应该转义。参见Dive Into Python 中的解释。
一些请求的例子:
对/articles/2005/03/ 的请求将匹配列表中的第三个模式。Django 将调用函数views.month_archive(request, '2005', '03')。
/articles/2005/3/ 不匹配任何URL 模式,因为列表中的第三个模式要求月份应该是两个数字。
/articles/2003/ 将匹配列表中的第一个模式不是第二个,因为模式按顺序匹配,第一个会首先测试是否匹配。请像这样自由插入一些特殊的情况来探测匹配的次序。
/articles/2003 不匹配任何一个模式,因为每个模式要求URL 以一个斜线结尾。
/articles/2003/03/03/ 将匹配最后一个模式。Django 将调用函数views.article_detail(request, '2003', '03', '03')。
命名组¶
上面的示例使用简单的、没有命名的正则表达式组(通过圆括号)来捕获URL 中的值并以位置 参数传递给视图。在更高级的用法中,可以使用命名的正则表达式组来捕获URL 中的值并以关键字 参数传递给视图。
在Python 正则表达式中,命名正则表达式组的语法是(?Ppattern),其中name 是组的名称,pattern 是要匹配的模式。
下面是以上URLconf 使用命名组的重写:
from django.conf.urls import url
from . import views
urlpatterns = [
url(r'^articles/2003/$', views.special_case_2003),
url(r'^articles/(?P[0-9]{4})/$', views.year_archive),
url(r'^articles/(?P[0-9]{4})/(?P[0-9]{2})/$', views.month_archive),
url(r'^articles/(?P[0-9]{4})/(?P[0-9]{2})/(?P[0-9]{2})/$', views.article_detail),
]
这个实现与前面的示例完全相同,只有一个细微的差别:捕获的值作为关键字参数而不是位置参数传递给视图函数。例如:
/articles/2005/03/ 请求将调用views.month_archive(request, year='2005', month='03')函数,而不是views.month_archive(request, '2005', '03')。
/articles/2003/03/03/ 请求将调用函数views.article_detail(request, year='2003', month='03', day='03&