Django之路由層

時間  2019-11-07
標籤 django 路由 欄目 Python 简体版
原文   原文鏈接

Django之路由層

路由是個啥

undefined

路由即請求地址與視圖函數的映射關係，若是把網站比喻爲一本書，那路由就比如是這本書的目錄，在Django中路由默認配置在urls.py中，以下圖：html

undefined

簡單的路由配置

# urls.py 
from django.conf.urls import url

# 由一條條映射關係組成的urlpatterns這個列表稱之爲路由表
urlpatterns = [
     url(regex, view, kwargs=None, name=None), # url本質就是一個函數
]
#函數url關鍵參數介紹
# regex：正則表達式,用來匹配url地址的路徑部分，
        # 例如url地址爲：http://127.0.0.1:8001/index/，正則表達式要匹配的部分是index/
# view：一般爲一個視圖函數，用來處理業務邏輯
# kwargs：略（用法詳見有名分組）
# name：略（用法詳見反向解析）

案例：python

urls.py文件git

from django.conf.urls import url
from django.contrib import admin
from app01 import views # 導入模塊views.py

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    url(r'^index/$',views.index), # 新增一條
]

views.py文件正則表達式

from django.shortcuts import render
from django.shortcuts import HttpResponse # 導入HttpResponse，用來生成響應信息

# 新增視圖函數index
def index(request):
    return HttpResponse('index page...')

測試：django

python manage.py runserver 8001 # 在瀏覽器輸入：http://127.0.0.1:8001/index/ 會看到 index page...

注意一：瀏覽器

剛剛咱們在瀏覽器輸入：http://127.0.0.1:8001/index/，Django會拿着路徑部分index/去路由表中自上而下匹配正則表達式，一旦匹配成功，則當即執行其後的視圖函數，不會繼續往下匹配，此處匹配成功的正則表達式是`r'^index/$’。**app

注意二：函數

可是咱們在瀏覽器輸入：http://127.0.0.1:8001/index，Django一樣會拿着路徑部分index去路由表中自上而下匹配正則表達式，貌似並不會匹配成功任何正則表達式（r'^index/$'匹配的是必須以/ 結尾，因此不會匹配成功index），但實際上仍然會看到結果 index page..…，緣由以下：post

在配置文件settings.py中有一個參數APPEND_SLASH，該參數有兩個值True或False測試

當APPEND_SLASH=True（若是配置文件中沒有該配置，APPEND_SLASH的默認值爲True），而且用戶請求的url地址的路徑部分不是以 / 結尾，例如請求的url地址是 http://127.0.0.1:8001/index，Django會拿着路徑部分（即index）去路由表中匹配正則表達式，發現匹配不成功，那麼Django會在路徑後加/（即index/）再去路由表中匹配，若是匹配失敗則會返回路徑未找到，若是匹配成功，則會返回重定向信息給瀏覽器，要求瀏覽器從新向 http://127.0.0.1:8001/index/地址發送請求。

當APPEND_SLASH=False時，則不會執行上述過程，即一旦url地址的路徑部分匹配失敗就當即返回路徑未找到，不會作任何的附加操做

分組

undefined

什麼是分組、爲什麼要分組呢？好比咱們開發了一個博客系統，當咱們須要根據文章的id查看指定文章時，瀏覽器在發送請求時須要向後臺傳遞參數（文章的id號），可使用 http://127.0.0.1:8001/article/?id=3，也能夠直接將參數放到路徑中http://127.0.0.1:8001/article/3/

針對後一種方式Django就須要直接從路徑中取出參數，這就用到了正則表達式的分組功能了，分組分爲兩種：無名分組與有名分組

undefined

無名分組

urls.py文件

from django.conf.urls import url
from django.contrib import admin
from app01 import views

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    # 下述正則表達式會匹配url地址的路徑部分爲:article/數字/，匹配成功的分組部分會以位置參數的形式傳給視圖函數，有幾個分組就傳幾個位置參數
    url(r'^aritcle/(\d+)/$',views.article), 
]

views.py文件

from django.shortcuts import render
from django.shortcuts import HttpResponse

# 須要額外增長一個形參用於接收傳遞過來的分組數據
def article(request,article_id):
    return HttpResponse('id爲 %s 的文章內容...' %article_id)

測試：

python manage.py runserver 8001 # 在瀏覽器輸入：http://127.0.0.1:8001/article/3/ 會看到: id爲 3 的文章內容...

有名分組

urls.py文件

from django.conf.urls import url
from django.contrib import admin
from app01 import views

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    # 該正則會匹配url地址的路徑部分爲:article/數字/，匹配成功的分組部分會以關鍵字參數（article_id=匹配成功的數字）的形式傳給視圖函數，有幾個有名分組就會傳幾個關鍵字參數
    url(r'^aritcle/(?P<article_id>\d+)/$',views.article), 
]

views.py文件

from django.shortcuts import render
from django.shortcuts import HttpResponse

# 須要額外增長一個形參，形參名必須爲article_id
def article(request,article_id):
    return HttpResponse('id爲 %s 的文章內容...' %article_id)

測試：

python manage.py runserver 8001 # 在瀏覽器輸入：http://127.0.0.1:8001/article/3/ 會看到: id爲 3 的文章內容...

總結：有名分組和無名分組都是爲了獲取路徑中的參數，並傳遞給視圖函數，區別在於無名分組是以位置參數的形式傳遞，有名分組是以關鍵字參數的形式傳遞。

強調：無名分組和有名分組不要混合使用

路由分發

undefined

隨着項目功能的增長，app會愈來愈多，路由也愈來愈多，每一個app都會有屬於本身的路由，若是再將全部的路由都放到一張路由表中，會致使結構不清晰，不便於管理，因此咱們應該將app本身的路由交由本身管理，而後在總路由表中作分發，具體作法以下

  1. 建立兩個app
# 新建項目mystie2
E:\git>django-admin startproject mysite2
# 切換到項目目錄下
E:\git>cd mysite2
# 建立app01和app02
E:\git\mysite2>python3 manage.py startapp app01
E:\git\mysite2>python3 manage.py startapp app02

2.在每一個app下手動建立urls.py來存放本身的路由，以下：

app01下的urls.py文件

from django.conf.urls import url
# 導入app01的views
from app01 import views

urlpatterns = [
    url(r'^index/$',views.index), 
]

app01下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse

def index(request):
    return HttpResponse('我是app01的index頁面...')

app02下的urls.py文件

from django.conf.urls import url
# 導入app02的views
from app02 import views

urlpatterns = [
    url(r'^index/$',views.index), 
]

app02下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse

def index(request):
    return HttpResponse('我是app02的index頁面...')
  1. 在總的urls.py文件中（mysite2文件夾下的urls.py）
from django.conf.urls import url,include
from django.contrib import admin

# 總路由表
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    # 新增兩條路由，注意不能以$結尾
    # include函數就是作分發操做的，當在瀏覽器輸入http://127.0.0.1:8001/app01/index/時，會先進入到總路由表中進行匹配，正則表達式r'^app01/'會先匹配成功路徑app01/，而後include功能會去app01下的urls.py中繼續匹配剩餘的路徑部分
    url(r'^app01/', include('app01.urls')),
    url(r'^app02/', include('app02.urls')),
]

測試：

python manage.py runserver 8001  
# 在瀏覽器輸入：http://127.0.0.1:8001/app01/index/ 會看到:我是app01的index頁面...
# 在瀏覽器輸入：http://127.0.0.1:8001/app02/index/ 會看到:我是app02的index頁面...

undefined

反向解析

undefined

在軟件開發初期，url地址的路徑設計可能並不完美，後期須要進行調整，若是項目中不少地方使用了該路徑，一旦該路徑發生變化，就意味着全部使用該路徑的地方都須要進行修改，這是一個很是繁瑣的操做。

解決方案就是在編寫一條url(regex, view, kwargs=None, name=None)時，能夠經過參數name爲url地址的路徑部分起一個別名，項目中就能夠經過別名來獲取這個路徑。之後不管路徑如何變化別名與路徑始終保持一致。

上述方案中經過別名獲取路徑的過程稱爲反向解析

案例：登陸成功跳轉到index.html頁面

在urls.py文件中

from django.conf.urls import url
from django.contrib import admin
from app01 import views
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    url(r'^login/$', views.login,name='login_page'), # 路徑login/的別名爲login_page
    url(r'^index/$', views.index,name='index_page'), # 路徑index/的別名爲index_page
]

在views.py中

from django.shortcuts import render 
from django.shortcuts import reverse # 用於反向解析
from django.shortcuts import redirect #用於重定向頁面
from django.shortcuts import HttpResponse

def login(request):
    if request.method == 'GET':
        # 當爲get請求時，返回login.html頁面,頁面中的{% url 'login_page' %}會被反向解析成路徑：/login/
        return render(request, 'login.html')
    
    # 當爲post請求時，能夠從request.POST中取出請求體的數據
    name = request.POST.get('name')
    pwd = request.POST.get('pwd')
    if name == 'kevin' and pwd == '123':
        url = reverse('index_page')  # reverse會將別名'index_page'反向解析成路徑：/index/       
        return redirect(url) # 重定向到/index/
    else:
        return HttpResponse('用戶名或密碼錯誤')


def index(request):
    return render(request, 'index.html')

login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>登陸頁面</title>
</head>
<body>
<!--強調：login_page必須加引號-->
<form action="{% url 'login_page' %}" method="post">
    {% csrf_token %} <!--強調：必須加上這一行，後續咱們會詳細介紹-->
    <p>用戶名：<input type="text" name="name"></p>
    <p>密碼：<input type="password" name="pwd"></p>
    <p><input type="submit" value="提交"></p>

</form>
</body>
</html>

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首頁</title>
</head>
<body>
<h3>我是index頁面...</h3>
</body>
</html>

測試：

python manage.py runserver 8001  
# 在瀏覽器輸入：http://127.0.0.1:8001/login/ 會看到登陸頁面，輸入正確的用戶名密碼會跳轉到index.html
# 當咱們修改路由表中匹配路徑的正則表達式時，程序其他部分均無需修改

總結：

在views.py中，反向解析的使用：
    url = reverse('index_page')
在模版login.html文件中，反向解析的使用
    {% url 'login_page' %}

拓展閱讀

若是路徑存在分組的反向解析使用：

from django.conf.urls import url
from django.contrib import admin
from app01 import views
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    url(r'^aritcle/(\d+)/$',views.article,name='article_page'), #　無名分組
    url(r'^user/(?P<uid>\d+)/$',views.article,name='user_page'), # 有名分組
]
# 1 針對無名分組，好比咱們要反向解析出：/aritcle/1/ 這種路徑，寫法以下
在views.py中，反向解析的使用：
    url = reverse('article_page',args=(1,)) 
在模版login.html文件中，反向解析的使用
    {% url 'article_page' 1 %}

    
# 2 針對有名分組，好比咱們要反向解析出：/user/1/ 這種路徑，寫法以下
在views.py中，反向解析的使用：
    url = reverse('user_page',kwargs={'uid':1}) 
在模版login.html文件中，反向解析的使用
    {% url 'user_page' uid=1 %}

名稱空間

undefined

當咱們的項目下建立了多個app，而且每一個app下都針對匹配的路徑起了別名，若是別名存在重複，那麼在反向解析時則會出現覆蓋，以下

  1. 建立兩個app
# 新建項目mystie2
E:\git>django-admin startproject mysite2
# 切換到項目目錄下
E:\git>cd mysite2
# 建立app01和app02
E:\git\mysite2>python3 manage.py startapp app01
E:\git\mysite2>python3 manage.py startapp app02
  1. 在每一個app下手動建立urls.py來存放本身的路由，而且爲匹配的路徑起別名

app01下的urls.py文件

from django.conf.urls import url
from app01 import views

urlpatterns = [
    # 爲匹配的路徑app01/index/起別名'index_page'
    url(r'^index/$',views.index,name='index_page'), 
]

app02下的urls.py文件

from django.conf.urls import url
from app02 import views

urlpatterns = [
    # 爲匹配的路徑app02/index/起別名'index_page',與app01中的別名相同
    url(r'^index/$',views.index,name='index_page'), 
]
  1. 在每一個app下的view.py中編寫視圖函數，在視圖函數中針對別名'index_page'作反向解析

app01下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse
from django.shortcuts import reverse

def index(request):
    url=reverse('index_page')
    return HttpResponse('app01的index頁面，反向解析結果爲%s' %url)

app02下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse
from django.shortcuts import reverse

def index(request):
    url=reverse('index_page')
    return HttpResponse('app02的index頁面，反向解析結果爲%s' %url)
  1. 在總的urls.py文件中（mysite2文件夾下的urls.py）
from django.conf.urls import url,include
from django.contrib import admin

# 總路由表
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    # 新增兩條路由，注意不能以$結尾
    url(r'^app01/', include('app01.urls')),
    url(r'^app02/', include('app02.urls')),
]

四、測試：

python manage.py runserver 8001

在測試時，不管在瀏覽器輸入：http://127.0.0.1:8001/app01/index/仍是輸入http://127.0.0.1:8001/app02/index/ 針對別名'index_page'反向解析的結果都是/app02/index/，覆蓋了app01下別名的解析。

undefined

解決這個問題的方法之一就是避免使用相同的別名，若是就想使用相同的別名，那就須要用到django中名稱空間的概念，將別名放到不一樣的名稱空間中，這樣即使是出現重複，彼此也不會衝突，具體作法以下

  1. 總urls.py在路由分發時，指定名稱空間
from django.conf.urls import url, include
from django.contrib import admin

# 總路由表
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    
    # 傳給include功能一個元組，元組的第一個值是路由分發的地址，第二個值則是咱們爲名稱空間起的名字
    url(r'^app01/', include(('app01.urls','app01'))),
    url(r'^app02/', include(('app02.urls','app02'))),
]
  1. 修改每一個app下的view.py中視圖函數，針對不一樣名稱空間中的別名'index_page'作反向解析

app01下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse
from django.shortcuts import reverse

def index(request):
    url=reverse('app01:index_page') # 解析的是名稱空間app01下的別名'index_page'
    return HttpResponse('app01的index頁面，反向解析結果爲%s' %url)

app02下的views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse
from django.shortcuts import reverse

def index(request):
    url=reverse('app02:index_page') # 解析的是名稱空間app02下的別名'index_page'
    return HttpResponse('app02的index頁面，反向解析結果爲%s' %url)
  1. 測試：
python manage.py runserver 8001

瀏覽器輸入：http://127.0.0.1:8001/app01/index/反向解析的結果是/app01/index/

在瀏覽器輸入http://127.0.0.1:8001/app02/index/ 反向解析的結果是/app02/index/

總結+補充

一、在視圖函數中基於名稱空間的反向解析，用法以下
url=reverse('名稱空間的名字:待解析的別名')

二、在模版裏基於名稱空間的反向解析，用法以下
<a href="{% url '名稱空間的名字:待解析的別名'%}">哈哈</a>

django2.0版的re_path與path

re_path

Django2.0中的re_path與django1.0的url同樣，傳入的第一個參數都是正則表達式

from django.urls import re_path # django2.0中的re_path
from django.conf.urls import url # 在django2.0中一樣能夠導入1.0中的url

urlpatterns = [
    # 用法徹底一致
    url(r'^app01/', include(('app01.urls','app01'))),
    re_path(r'^app02/', include(('app02.urls','app02'))),
]

path

在Django2.0中新增了一個path功能，用來解決：數據類型轉換問題與正則表達式冗餘問題，以下

urls.py文件

from django.urls import re_path

from app01 import views

urlpatterns = [
    # 問題一：數據類型轉換
    # 正則表達式會將請求路徑中的年份匹配成功而後以str類型傳遞函數year_archive，在函數year_archive中若是想以int類型的格式處理年份，則必須進行數據類型轉換
    re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

    # 問題二：正則表達式冗餘
    # 下述三個路由中匹配article_id採用了一樣的正則表達式，重複編寫了三遍，存在冗餘問題，而且極不容易管理，由於一旦article_id規則須要改變，則必須同時修改三處代碼
    
    re_path(r'^article/(?P<article_id>[a-zA-Z0-9]+)/detail/$', views.detail_view),
    re_path(r'^articles/(?P<article_id>[a-zA-Z0-9]+)/edit/$', views.edit_view),
    re_path(r'^articles/(?P<article_id>[a-zA-Z0-9]+)/delete/$', views.delete_view),
]

views.py

from django.shortcuts import render,HttpResponse

# Create your views here.
def year_archive(request,year):
    print(year,type(year))
    return HttpResponse('year_archive page')

def detail_view(request,article_id):
    print(article_id, type(article_id))
    return HttpResponse('detail_view page')

def edit_view(request,article_id):
    print(article_id, type(article_id))
    return HttpResponse('edit_view page')

def delete_view(request,article_id):
    print(article_id, type(article_id))
    return HttpResponse('delete_view page')

undefined

Django2.0中的path如何解決上述兩個問題的呢？請看示例

from django.urls import path,re_path

from app01 import views

urlpatterns = [
    # 問題一的解決方案：
    path('articles/<int:year>/', views.year_archive), # <int:year>至關於一個有名分組，其中int是django提供的轉換器，至關於正則表達式，專門用於匹配數字類型，而year則是咱們爲有名分組命的名，而且int會將匹配成功的結果轉換成整型後按照格式（year=整型值）傳給函數year_archive


    # 問題二解決方法：用一個int轉換器能夠替代多處正則表達式
    path('articles/<int:article_id>/detail/', views.detail_view), 
    path('articles/<int:article_id>/edit/', views.edit_view),
    path('articles/<int:article_id>/delete/', views.delete_view),
]

強調：

#一、path與re_path或者1.0中的url的不一樣之處是，傳給path的第一個參數再也不是正則表達式，而是一個徹底匹配的路徑，相同之處是第一個參數中的匹配字符均無需加前導斜槓

#二、使用尖括號(<>)從url中捕獲值，至關於有名分組

#三、<>中能夠包含一個轉化器類型（converter type），好比使用 <int:name> 使用了轉換器int。若果沒有轉化器，將匹配任何字符串，固然也包括了 / 字符

undefined

django默認支持一下5種轉換器（Path converters）

str,匹配除了路徑分隔符（/）以外的非空字符串，這是默認的形式
int,匹配正整數，包含0。
slug,匹配字母、數字以及橫槓、下劃線組成的字符串。
uuid,匹配格式化的uuid，如 075194d3-6885-417e-a8a8-6c931e272f00。
path,匹配任何非空字符串，包含了路徑分隔符（/）（不能用？）

例如

path('articles/<int:year>/<int:month>/<slug:other>/', views.article_detail) 
# 針對路徑http://127.0.0.1:8000/articles/2009/123/hello/，path會匹配出參數year=2009,month=123,other='hello'傳遞給函數article_detail

很明顯針對月份month，轉換器int是沒法精準匹配的，若是咱們只想匹配兩個字符，那麼轉換器slug也沒法知足需求，針對等等這一系列複雜的須要，咱們能夠定義本身的轉化器。轉化器是一個類或接口，它的要求有三點：

  • regex 類屬性，字符串類型
  • to_python(self, value) 方法，value是由類屬性 regex 所匹配到的字符串，返回具體的Python變量值，以供Django傳遞到對應的視圖函數中。
  • to_url(self, value) 方法，和 to_python 相反，value是一個具體的Python變量值，返回其字符串，一般用於url反向引用。

自定義轉換器示例：

  1. 在app01下新建文件path_ converters.py,文件名能夠隨意命名

    class MonthConverter:
    regex='\d{2}' # 屬性名必須爲regex

    def to_python(self, value):
        return int(value)

    def to_url(self, value):
        return value # 匹配的regex是兩個數字，返回的結果也必須是兩個數字

  2. 在urls.py中，使用register_converter 將其註冊到URL配置中：

    from django.urls import path,register_converter
from app01.path_converts import MonthConverter

register_converter(MonthConverter,'mon')

from app01 import views


urlpatterns = [
    path('articles/<int:year>/<mon:month>/<slug:other>/', views.article_detail, name='aaa'),

]

  3. views.py中的視圖函數article_detail

    from django.shortcuts import render,HttpResponse,reverse

def article_detail(request,year,month,other):
    print(year,type(year))
    print(month,type(month))
    print(other,type(other))
    print(reverse('xxx',args=(1988,12,'hello'))) # 反向解析結果/articles/1988/12/hello/
    return HttpResponse('xxxx')

  4. 測試

    # 一、在瀏覽器輸入http://127.0.0.1:8000/articles/2009/12/hello/，path會成功匹配出參數year=2009,month=12,other='hello'傳遞給函數article_detail
# 二、在瀏覽器輸入http://127.0.0.1:8000/articles/2009/123/hello/，path會匹配失敗，由於咱們自定義的轉換器mon只匹配兩位數字，而對應位置的123超過了2位
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程