Django-路由控制
Django-路由控制
一、URL路由基礎
URL是web服務的路口,使用者通過瀏覽器傳送過來的任何請求都會被髮送到一個指定的URL地址裡,然後被響應。
在django專案中編寫路由就是向外暴露我們接收哪些URL的請求,除此之外任何的URL都不會被處理,URL路由就是web服務對外暴露的API
二、Django處理請求
- 確定要使用的
URLconf
模組,通常是settings中ROOT_URLCONF
設定的值,如果傳入的HttpRequest
物件具有urlconf
屬性(中介軟體設定),則使用其值代替settings中ROOT_URLCONF
- Django載入模組並查詢可用的
urlpatterns
django.conf.urls.url()
例項的一個列表 - 按順序執行每個URL模式,匹配成功就停下來,所以順序很關鍵
- 匹配成功匯入給定的檢視,它是一個python函式,或基於類的檢視,檢視將獲得如下引數
- 一個
HttpRequest
例項 - 如果匹配的正則表示式返回了無名分組,那麼它將作為位置引數提供給檢視
- 關鍵字引數由正則的有名分組組成,但是可以被
django.conf.urls.url()
的可選引數kwargs覆蓋
- 一個
- 如果沒有URL模式匹配,或者過程出錯了,將呼叫錯誤處理檢視
三、簡單的路由配置
from django.conf.urls import url urlpatterns=[ url(正則表示式,view檢視函式,引數,別名) ]
示例的URLconf:
from django.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這個字串中的任何字元都不應該被轉義
請求的例子及匹配的url
/articles/2005/03/將匹配列表中的第三個模式。Django將呼叫函式views.month_archive(request, '2005', '03')。
/articles/2005/3/不匹配任何URL模式,因為列表中的第三個模式要求月份是兩個數字。
/articles/2003/將匹配列表中的第一個模式不是第二個,因為模式按順序從上往下匹配,第一個會首先被匹配。Django會呼叫函式views.special_case_2003(request)
/articles/2003不匹配任何一個模式,因為每個模式都要求URL以一個斜槓結尾。
/articles/2003/03/03/將匹配最後一個模式。Django將呼叫函式views.article_detail(request, '2003', '03', '03')。
是否開啟URL訪問地址後面 不為/跳轉至帶有/路徑的配置項
APPEND_SLASH=True
Django settings.py配置檔案中預設沒有 APPEND_SLASH 這個引數,但 Django 預設這個引數為 APPEND_SLASH = True。 其作用就是自動在網址結尾加'/'。
四、有名分組
有名分組的語法是(?P<name>pattern)
,其中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<year>[0-9]{4})/$', views.year_archive),
url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive),
url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail),
]
注:捕獲的值作為關鍵字引數而不是位置引數傳遞給檢視函式。
/articles/2005/03/
請求將呼叫views.month_archive(request, year='2005', month='03')
函式,而不是views.month_archive(request, '2005', '03')
。
五、無名分組有名分組總結
1.無名分組
按位置傳參
分組之後,將分組好的資料當做位置傳參到檢視函式,所以檢視函式需要定義形參
示例:
url:
(r'^articles/([0-9]{4})/([0-9]{2})$', views.article_detail)
檢視函式:
def article_detail(request,*args)
2.有名分組
按關鍵字傳參
分組後,會把分組出來的資料當做關鍵字引數傳到檢視函式,所以檢視函式需要定義形參,形參名字和分組的名字相對應,與順序無關
示例:
url:
(r'^articles/(?P<year>[0-9]{4})/(?P<mounth>[0-9]{2})/$', views.article_detail),
檢視函式:
def article_detail(request,mounth,year)
注:有名分組和無名分組最好不要混用
六、反向解析
在django專案中,一個常見的需求是獲得URL的最終形式,以用於嵌入到生成的內容中(檢視中和顯示給使用者的URL等)或者用於處理伺服器端的導航(重定向)。不希望通過硬編碼URL
Django提供了一種解決方案,只需在URL中提供一個name引數,並賦值一個你自定義的、好記的、直觀的字串。
- 在模板中:使用url模板標籤
- 在python程式碼中,使用reverse()函式
示例:
url配置:
- 無引數:
url(r'^publishadd111/$',views.publishadd,name='ddd'),
- 無名分組:
url(r'^publishadd/([0-9]{4})/([0-9]{2})/$', views.publishadd,name='ddd'),
- 有名分組:
url(r'^publishadd/(?P<year>[0-9]{4})/(?P<mounth>[0-9]{2})/$',views.publishadd,name='ddd'),
模板層:
- 無引數:
{% url 'ddd' %}
- 無名分組:
{% url 'ddd' 2018 12 %}
空格隔開,傳多個值 - 有名分組:
{% url 'ddd' 2018 12 %}
還可以{% url 'ddd' year=2018 mounth=12 %}
檢視層:
from django.shortcuts import reverse
- 無引數:
url=reverse('ddd')
- 無名分組:
url=reverse('ddd',args=(2018,12,))
- 有名分組:
url=reverse('ddd',args=(2018,12,))
還可以url=reverse('ddd',kwargs={'year':2018,'mounth':12})
七、路由分發
在每個app裡各自建立一個urls.py路由模組,然後從根路由出發,將app所屬的url請求全部轉發到相應的urls.py模組中。
Django1.1版本的分發
from django.conf.urls import url,include
例子:
總路由:
-from django.conf.urls import include
-url(r'^blog/',include('blog.urls')),
-url(r'^app01/',include('app01.urls')),
各自路由配置url
app01--url(r'^publish/$', views.publish,name='app01_test'),
blog--url(r'^blogtest/$', views.test,name='blog_test'),
路由分發使用的是include()方法,需要提前匯入,他的引數是轉發目的地地路徑的字串。
重點:總路由後面不能加$
兩個不同的app,在各自的urlconf中為某一條url取了相同的name,這就會帶來麻煩。為了解決這個問題,又引出了下面的名稱空間。
八、名稱空間
由於name沒有作用域,Django在反解URL時,會在專案全域性順序搜尋,當查詢到第一個name指定URL時,立即返回。URL名稱空間可以保證反查到唯一的URL,即使不同的app使用相同的URL名稱。
示例:
urls.py
url(r'^blog/',include('blog.urls')),
url(r'^app01/',include('app01.urls')),
blog的urls.py
url(r'^blogtest/$', views.test,name='test'),
app01的urls.py
url(r'^publish/$', views.publish,name='test'),
blog的檢視函式
def test(request):
url=reverse('test')
return HttpResponse('blog test)
app01的檢視函式
def test(request):
url=reverse('test')
return HttpResponse('app01 test)
無論如何找index都是找的app01的index。
解決方法:在總路由分發的時候指定名稱空間,實現名稱空間的做法很簡單,在urlconf檔案中新增namespace='xxx'
即可。
url(r'^blog/',include('blog.urls',namespace='blog')),
url(r'^app01/',include('app01.urls',namespace='app01')),
在檢視函式反向解析的時候,指定是哪個名稱空間下的
url = reverse('blog:test')
在模板裡也指定是
{% url 'blog:test'%}
不是很推薦使用名稱空間,推薦的是在子路由的name中加入app的字首
url(r'^publish/$', views.publish,name='app01_test'),
九、偽靜態
和真靜態URL類似。他是通過偽靜態規則把動態URL偽裝成靜態網址。
在urls.py檔案中自己新增匹配.html
url(r'^book/(?P<id>\d+.html)',views.book),