03.DjangoURL路由
DjangoURL路由
01.捕获的参数永远是字符串:
每个捕获的参数都作为一个普通的Python 字符串传递给视图，无论正则表达式使用的是什么匹配方式
例如，下面这行URLconf 中：
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
year_archive:str类型
02.指定视图参数的默认值:
# 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)
def page(request, num="1"):
......
上述情况，两个URL模式指向同一个视图views.page —— 但是第一个模式不会从URL 中捕获任何值。
如果第一个模式匹配，page() 函数将使用num参数的默认值"1"。
如果第二个模式匹配，page() 将使用正则表达式捕获的num 值。
03.includ分发：
当有多个app项目时，需要对路由进行分发，并在自己的目录下创建urls.py
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，如果做了反向解析则不需要
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 ]
