路由詳解(Router)
開篇祭神圖,biuibiubiu…
1. 路由位置定義
Django的主要路由信息定義在工程同名目錄下的urls.py文件中,該文件是Django解析路由的入口。
每個子應用爲了保持相對獨立,可以在各個子應用中定義屬於自己的urls.py來保存該應用的路由;然後用主路由文件包含各應用的子路由數據。
除了上述方式外,也可將工程的全部路由信息都定義在主路由文件中,子應用不再設置urls.py。如:
from django.conf.urls import url
from django.contrib import admin
import users.views
urlpatterns = [
url(r'^admin/', admin.site.urls), #Django默認的路由
url(r'^users/index/$', users.views.index) #自己動手配置
]
2. 路由解析順序
Django在接收到一個請求時,從主路由文件中的urlpatterns列表中按照由上至下的順序查找對應路由規則,如果發現規則爲include包含,則再進入被包含的urls中的urlpatterns列表由上至下進行查詢。
敲黑板:內容有點繞,大家反覆閱讀三遍,並理解記憶
值得關注的由上至下的順序,有可能會使上面的路由屏蔽掉下面的路由,帶來非預期結果。例如:
urlpatterns = [
url(r'^say', views.say),
url(r'^sayhello', views.sayhello),
]
即本來想要訪問sayhello/路徑,按照我們的想法,應該執行視圖sayhello,但實際優先查找到了say路由規則也與sayhello/路徑匹配,實際進入了say視圖執行,所以,此處大家需要特別注意一下:定義路由的順序,避免出現屏蔽效應。
3. 路由命名與reverse反解析(逆向)
3.1 路由命名
在定義路由的時候,可以爲路由命名,方便查找特定視圖的具體路徑信息。
- 在使用include函數定義路由時,可以使用namespace參數定義路由的命名空間,如:
url(r'^users/', include('users.urls', namespace='users')),
namespace命名空間表示,凡是users.urls中定義的路由,均屬於namespace指明的users名下。
命名空間的作用:避免不同應用中的路由使用了相同的名字發生衝突,使用命名空間區別開。
- 在定義普通路由時,可以使用name參數指明路由的名字,如:
urlpatterns = [
url(r'^index/$', views.index, name='index'),
url(r'^say', views.say, name='say'),
]
3.2 reverse反解析
使用reverse函數,可以根據路由名稱,返回具體的路徑,如:
from django.urls import reverse # 注意導包路徑
def index(request):
return HttpResponse("hello the world!")
def say(request):
url = reverse('users:index') # 運行後返回 /users/index/
print(url)
return HttpResponse('say')
- 對於未指明namespace的,reverse(路由name)
- 對於指明namespace的,reverse(命名空間namespace:路由name)
4. 路徑結尾斜線/的說明
敲黑板,劃重點
Django中定義路由時,通常以斜線**/結尾,其好處是用戶訪問不以斜線/結尾的相同路徑時,Django會把用戶重定向到以斜線/**結尾的路徑上,而不會返回404報錯頁面不存在。如:
urlpatterns = [
url(r'^index/$', views.index, name='index'),
]
用戶訪問 index 或者 index/ 網址,均能訪問到index視圖,Django會自動把用戶重定向到以斜線**/**結尾的路徑上
說明:
雖然路由結尾帶**/**能帶來上述好處,但是卻違背了HTTP中URL表示資源位置路徑的設計理念,所以大家按需所用。
今天三連更,希望我的每一篇博文都能幫到所需之人,一個耿直的微笑送給你們,謝謝大家的來訪。
@Author:HaoXuan