Django框架之路由用法

Posted on by

簡介

路由簡單的來說就是根據用戶請求的 URL 鏈接來判斷對應的處理程序，並返回處理結果，也就是 URL 與 Django 的視圖建立映射關系。

Django 路由在 urls.py 配置，urls.py 中的每一條配置對應相應的處理方法。

Django 不同版本 urls.py 配置有點不一樣：

1、Django1.1.x 版本

url() 方法：普通路徑和正則路徑均可使用，需要自己手動添加正則首位限制符號。

from django.conf.urls import url # 用 url 需要引入
urlpatterns = [
    url(r'^admin/$', admin.site.urls),
    url(r'^index/$', views.index), # 普通路徑
    url(r'^articles/([0-9]{4})/$', views.articles), # 正則路徑
]

2、Django 2.2.x 之後的版本

  • path：用於普通路徑，不需要自己手動添加正則首位限制符號，底層已經添加。
  • re_path：用於正則路徑，需要自己手動添加正則首位限制符號。
from django.urls import re_path # 用re_path 需要引入
urlpatterns = [
    path('admin/', admin.site.urls),
    path('index/', views.index), # 普通路徑
    re_path(r'^articles/([0-9]{4})/$', views.articles), # 正則路徑
]

總結：Django1.1.x 版本中的 url 和 Django 2.2.x 版本中的 re_path 用法相同。

二、正則路徑中的分組

1、正則路徑中的無名分組

無名分組按位置傳參，一一對應。

views 中除瞭 request，其他形參的數量要與 urls 中的分組數量一致。

urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path("^index/([0-9]{4})/$", views.index),
]

views.py

from django.shortcuts import HttpResponse
def index(request，year):
print(year) # 一個形參代表路徑中一個分組的內容，按順序匹配
return HttpResponse('菜鳥教程')

2、正則路徑中的有名分組

語法：

(?P<組名>正則表達式)

有名分組按關鍵字傳參，與位置順序無關。

views 中除瞭 request，其他形參的數量要與 urls 中的分組數量一致， 並且 views 中的形參名稱要與 urls 中的組名對應。

urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path("^index/(?P[0-9]{4})/(?P[0-9]{2})/$", views.index),
]

views.py

from django.shortcuts import HttpResponse
def index(request, year, month):
print(year,month) # 一個形參代表路徑中一個分組的內容，按關鍵字對應匹配
return HttpResponse('菜鳥教程')

3、路由分發(include)

存在問題：Django 項目裡多個app目錄共用一個 urls 容易造成混淆，後期維護也不方便。

解決：使用路由分發（include），讓每個app目錄都單獨擁有自己的 urls。

步驟：

  • 1、在每個 app 目錄裡都創建一個 urls.py 文件。
  • 2、在項目名稱目錄下的 urls 文件裡，統一將路徑分發給各個 app 目錄。
from django.contrib import admin
from django.urls import path,include # 從 django.urls 引入 include
urlpatterns = [
    path('admin/', admin.site.urls),
    path("app01/", include("app01.urls")),
    path("app02/", include("app02.urls")),
]

在各自 app 目錄下，寫自己的 urls.py 文件，進行路徑跳轉。

app01 目錄:

from django.urls import path,re_path 
from app01 import views # 從自己的 app 目錄引入 views 
urlpatterns = [ 
    re_path(r'^login/(?P<m>[0-9]{2})/$', views.index, ),
]

app02 目錄:

from django.urls import path,re_path
from app02 import views # 從自己的 app 目錄引入views 
urlpatterns = [ 
    re_path("^xxx/(?P[0-9]{4})/$", views.xxx), 
]

在各自 app 目錄下的 views.py 文件中寫各自的視圖函數。

三、反向解析

隨著功能的增加，路由層的 url 發生變化，就需要去更改對應的視圖層和模板層的 url，非常麻煩，不便維護。

這時我們可以利用反向解析，當路由層 url 發生改變，在視圖層和模板層動態反向解析出更改後的 url，免去修改的操作。

反向解析一般用在模板中的超鏈接及視圖中的重定向。

1、普通路徑

在 urls.py 中給路由起別名，name="路由別名"。

path("login1/", views.login, name="login")

在 views.py 中，從 django.urls 中引入 reverse，利用 reverse("路由別名") 反向解析:

return redirect(reverse("login"))

在模板 templates 中的 HTML 文件中，利用 {% url "路由別名" %} 反向解析。

<form action="{% url 'login' %}" method="post">

2、正則路徑（無名分組）

在 urls.py 中給路由起別名，name="路由別名"。

re_path(r"^login/([0-9]{2})/$", views.login, name="login")

在 views.py 中，從 django.urls 中引入 reverse，利用 reverse("路由別名"，args=(符合正則匹配的參數,)) 反向解析。

return redirect(reverse("login",args=(10,)))

在模板 templates 中的 HTML 文件中利用 {% url "路由別名" 符合正則匹配的參數 %} 反向解析。

<form action="{% url 'login' 10 %}" method="post">

3、正則路徑（有名分組）

在 urls.py 中給路由起別名，name="路由別名"。

re_path(r"^login/(?P<year>[0-9]{4})/$", views.login, name="login")

在 views.py 中，從 django.urls 中引入 reverse，利用 reverse("路由別名"，kwargs={"分組名":符合正則匹配的參數}) 反向解析。

return redirect(reverse("login",kwargs={"year":3333}))

在模板 templates 中的 HTML 文件中，利用 {% url "路由別名" 分組名=符合正則匹配的參數 %} 反向解析。

<form action="{% url 'login' year=3333 %}" method="post">

四、命名空間

命名空間（英語：Namespace）是表示標識符的可見范圍。

一個標識符可在多個命名空間中定義，它在不同命名空間中的含義是互不相幹的。

一個新的命名空間中可定義任何標識符，它們不會與任何重復的標識符發生沖突，因為重復的定義都處於其它命名空間中。

存在問題：路由別名 name 沒有作用域，Django 在反向解析 URL 時，會在項目全局順序搜索，當查找到第一個路由別名 name 指定 URL 時，立即返回。當在不同的 app 目錄下的urls 中定義相同的路由別名 name 時，可能會導致 URL 反向解析錯誤。

解決：使用命名空間。

普通路徑

定義命名空間（include 裡面是一個元組）格式如下：

include(("app名稱：urls"，"app名稱"))

實例：

path("app01/", include(("app01.urls","app01"))) 
path("app01/", include(("app02.urls","app02")))

在 app01/urls.py 中起相同的路由別名。

path("login/", views.login, name="login")

在 views.py 中使用名稱空間，語法格式如下：

reverse("app名稱：路由別名")

實例：

return redirect(reverse("app01:login")

在 templates 模板的 HTML 文件中使用名稱空間，語法格式如下：

{% url "app名稱：路由別名" %}

實例：

<form action="{% url 'app01:login' %}" method="post">

到此這篇關於Django框架之路由用法的文章就介紹到這瞭。希望對大傢的學習有所幫助，也希望大傢多多支持WalkonNet。

推薦閱讀：