DjangoURL路由python
01.捕获的参数永远是字符串:git
每一个捕获的参数都做为一个普通的Python 字符串传递给视图,不管正则表达式使用的是什么匹配方式
例如,下面这行URLconf 中:正则表达式
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
year_archive:str类型django
02.指定视图参数的默认值:app
# URLconf函数
from django.conf.urls import url from . import views
urlpatterns = [ url(r'^blog/$', views.page), url(r'^blog/page(?P<num>[0-9]+)/$', views.page), ]
# View (in blog/views.py)ui
def page(request, num="1"): ......
上述状况,两个URL模式指向同一个视图views.page —— 可是第一个模式不会从URL 中捕获任何值。
若是第一个模式匹配,page() 函数将使用num参数的默认值"1"。
若是第二个模式匹配,page() 将使用正则表达式捕获的num 值。url
03.includ分发:
当有多个app项目时,须要对路由进行分发,并在本身的目录下建立urls.pyspa
from django.conf.urls import include # 导入include urlpatterns = [ re_path(r'^admin/', admin.site.urls), re_path(r'^blog/', include('blog.urls')), re_path(r'^', include('comment.urls')),
# 建议若是进行分组,在url中不输入值,直接跳转对应的app下的路由urls,若是作了反向解析则不须要code
04.反向解析:
为了让url路径不固定,可以根据需求的变化而变化,则用到反向解析
(1)在模板中:使用url 模板标签
1 # urls.py中 2 urlpatterns = [ 3 #... 4 re_path(r'^articles/([0-9]{4})/$', views.year_archive, name='news-year-archive'), 5 #... 6 ] 7 其中:name为反向解析名称 8 9 # templates模板中 10 <a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a> 11 <ul> 12 {% for yearvar in year_list %} 13 <li><a href="{% url 'news-year-archive' yearvar %}">{{ yearvar }} Archive</a></li> 14 {% endfor %} 15 </ul>
其中:{% url 'urls中反向解析名称' 路径参数%}使用模板语法在render加载页面时遇到{%%}进行
反向解析,找到url路由下name='反向解析名称',拿到对应的url地址,若是地址有正则参数,
须要在模板语法中添加对应要求的参数
(2)在视图函数中:使用reverse函数进行反向解析
1 # views.py中 2 from django.urls import reverse # 导入反向解析函数 3 from django.http import HttpResponseRedirect 4 5 def redirect_to_year(request): 6 # ... 7 year = 2006 8 # ... 9 return HttpResponseRedirect(reverse('news-year-archive', args=(year,))) # 同redirect("/path/")
其中:reverse('urls中反向解析名称', args=(正则参数,))拿到对应的url地址
05.名称空间
咱们在开发项目时,会常常使用name属性反解出URL,
当不当心在不一样的app的urls中定义相同的name时,可能会致使URL反解错误,
为了不这种事情发生,引入了命名空间namespace=''
1 # urls.py下 2 urlpatterns = [ 3 re_path(r'^admin/', admin.site.urls), 4 re_path(r'^app01/', include("app01.urls",namespace="app01")), 5 re_path(r'^app02/', include("app02.urls",namespace="app02")), 6 ] 7 8 # app01.urls: 9 urlpatterns = [ 10 re_path(r'^index/', index,name="index"), 11 ] 12 13 # app02.urls: 14 urlpatterns = [ 15 re_path(r'^index/', index,name="index"), 16 ] 17 18 # app01.views: 19 from django.core.urlresolvers import reverse 20 def index(request): 21 return HttpResponse(reverse("app01:index")) 22 23 # app02.views: 24 from django.core.urlresolvers import reverse 25 def index(request): 26 return HttpResponse(reverse("app02:index"))
其中:reverse("namespace名称空间:name反向解析标识符")
06.path转换器
对url路径正则匹配的值进行转换,而不是使用默认的str类型
1 from django.urls import path 2 from . import views 3 urlpatterns = [ 4 path('articles/2003/', views.special_case_2003), 5 path('articles/<int:year>/', views.year_archive), 6 path('articles/<int:year>/<int:month>/', views.month_archive), 7 path('articles/<int:year>/<int:month>/<slug>/', views.article_detail), 8 ]
基本规则:
(1)使用尖括号<>从url中捕获值。
(2)捕获值中能够包含一个转化器类型(converter type),好比使用 捕获一个整数变量。若果没有转化器,将匹配任何字符串,固然也包括了 / 字符。
(3)无需添加前导斜杠。
Django默认支持如下5个转化器:
str,匹配除了路径分隔符(/)以外的非空字符串,这是默认的形式
int,匹配正整数,包含0。
slug,匹配字母、数字以及横杠、下划线组成的字符串。
uuid,匹配格式化的uuid,如 075194d3-6885-417e-a8a8-6c931e272f00。
path,匹配任何非空字符串,包含了路径分隔符
*注册自定义转化器(定义一次规则,反复使用):
对于一些复杂或者复用的须要,能够定义本身的转化器。转化器是一个类或接口,它的要求有三点:
(1)regex 类属性,字符串类型
(2)to_python(self, value) 方法,value是由类属性 regex 所匹配到的字符串,返回具体的Python变量值,以供Django传递到对应的视图函数中。
(3)to_url(self, value) 方法,和 to_python 相反,value是一个具体的Python变量值,返回其字符串,一般用于url反向引用。
1 class FourDigitYearConverter: # 转换器 2 regex = '[0-9]{4}' # 匹配规则 3 def to_python(self, value): # 匹配成功传出转换值 4 return int(value) 5 def to_url(self, value): # 反向解析 6 return '%04d' % value 7 8 # in url 9 10 from django.urls import register_converter # 引入转换器 11 register_converter(FourDigitYearConverter, 'yyyy') # 注册一个转换器,起别名yyyy 12 urlpatterns = [ 13 path('articles/2003/', views.special_case_2003), 14 path('articles/<yyyy:year>/', views.year_archive), 15 ... 16 ]