Django之urls分发控制
路由基本配置
URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表;
你就是以这种方式告诉Django,对于客户端发来的某个URL调用哪一段逻辑代码对应执行。
创建一个Django项目后,在项目目录下会有一个urls.py文件。该文件就是存放路由配置(映射关系)的文件。
如下图:
注意:2版本支持1版本的分发控制写法,把path换成re_path就可以了,相当于上图的url
分组
由于关系映射里写的是正则表达式,想要分组直接用正则语法的圆括号就行了
如果在接收参数时不想因为分组的顺序而影响接收参数的顺序,在分组时为每个组起一个组名,这样传参时会按照函数的形参名一一对应传参,前提是组名必须跟对应的形参名一致。如下图:
2版本时,由于映射关系并不是直接写正则匹配,有名分组的写法为:
1、使用尖括号<>
从url中捕获值。
2、捕获值中可以包含一个转化器类型(converter type),比如使用 <int:name>
捕获一个整数变量。若果没有转化器,将匹配任何字符串,当然也包括了 /
字符。
3、无需添加前倒斜杠
Django默认支持以下5个转化器:
str,匹配除了路径分隔符(/
)之外的非空字符串,这是默认的形式
int,匹配正整数,包含0。
slug,匹配字母、数字以及横杠、下划线组成的字符串。
uuid,匹配格式化的uuid,如 075194d3-6885-417e-a8a8-6c931e272f00。
path,匹配任何非空字符串,包含了路径分隔符
自定义转化器
对于一些复杂或者复用的需要,可以定义自己的转化器。转化器是一个类或接口,它的要求有三点:
regex
类属性,字符串类型
to_python(self, value)
方法,value是由类属性regex
所匹配到的字符串,返回具体的Python变量值,以供Django传递到对应的视图函数中。to_url(self, value)
方法,和to_python
相反,value是一个具体的Python变量值,返回其字符串,通常用于url反向引用。
例子:
class FourDigitYearConverter: regex = '[0-9]{4}' def to_python(self, value): return int(value) def to_url(self, value): return '%04d' % value
使用register_converter
将其注册到URL配置中:
from django.urls import register_converter, path from . import converters, views register_converter(converters.FourDigitYearConverter, 'yyyy') urlpatterns = [ path('articles/2003/', views.special_case_2003), path('articles/<yyyy:year>/', views.year_archive), ... ]
分发
假如一个project中有多个app,url管理可能会造成比较混乱的局面,为了解决这个问题,我们可以用include的方法来配置url。
首先我们在自己的app中建立一个urls.py,然后在里面写访问路径和视图函数的对应关系,在项目目录下的urls.py文件里写:
通过这样的url管理会更加清晰整洁,可扩展性也会增强
反向解析
在使用Django 项目时,一个常见的需求是获得URL 的最终形式,以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)。人们强烈希望不要硬编码这些URL(费力、不可扩展且容易产生错误)或者设计一种与URLconf 毫不相关的专门的URL 生成机制,因为这样容易导致一定程度上产生过期的URL。
在需要URL 的地方,对于不同层级,Django 提供不同的工具用于URL 反查:
- 在模板中:使用url 模板标签。
- 在Python 代码中:使用
from django.urls import reverse()函数
urls.py:
在模板中:
在视图函数中:
名称空间
命名空间(英语:Namespace)是表示标识符的可见范围。一个标识符可在多个命名空间中定义,它在不同命名空间中的含义是互不相干的。这样,在一个新的命名空间中可定义任何标识符,它们不会与任何已有的标识符发生冲突,因为已有的定义都处于其它命名空间中。
1版本中的写法:
project的urls.py:
urlpatterns = [ re_path(r'^admin/', admin.site.urls), re_path(r'^app01/', include("app01.urls",namespace="app01")), re_path(r'^app02/', include("app02.urls",namespace="app02")), ]
app01.urls:
urlpatterns = [ re_path(r'^index/', index,name="index"), ]
app02.urls:
urlpatterns = [ re_path(r'^index/', index,name="index"), ]
app01.views
from django.core.urlresolvers import reverse def index(request): return HttpResponse(reverse("app01:index"))
app02.views
from django.core.urlresolvers import reverse def index(request): return HttpResponse(reverse("app02:index"))
在2版本中:
点击查看: