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 ]