2. 程式人生 > >django2筆記:路由path語法

django2筆記:路由path語法

阿新 • • 發佈：2018-07-22
接收 tin 動態 官方 register min 什麽 新版本 syntax

django2筆記:路由path語法

2017-09-25 | 編程 | 7595 1,907

技術分享圖片

9月23，Django 發布了2.0a1版本，這是一個 feature freeze 版本，如果沒有什麽意外的話，2.0正式版不會再增加新的功能了。按照以往的規律，預計正式版將在12月發布。

備註：Django 2.0 於12月2日已經正式發布。 （鏈接）

2.0無疑是一個裏程碑版本，移除了對 Python2.7 的支持，最少需要 3.4 以上，建議使用3.5以上的版本。

What’s new in Django2.0 文檔中一共列出了三個新的特性：

  • 更簡單的URL路由語法 (Simplified URL routing syntax)
  • admin應用的針對移動設備的優化改進(Mobile-friendly contrib.admin)
  • 支持SQL開窗表達式(Window expressions)

第一個特性，主要用於動態路由定義上。在Django2.0代碼實現中，主要的變化是新增了 django.urls.path 函數，它允許使用一種更加簡潔、可讀的路由語法。比如之前的版本的代碼：

1
 
url(r‘^articles/(?P<year>[0-9]{4})/$‘, views.year_archive),

在新版本中也可以寫為：

1
 
path(‘articles/<int:year>/‘, views.year_archive),

新語法支持類型轉化，在上述的例子中， year_archive 函數接收到的year參數就變成整數而不是字符串。

如果你有接觸過 Flask 框架，就會發現和 Variable-Rules 的語法形式和功能都是相類似的。

一 問題引入

下面是 Django1.X 的一段代碼：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
from django.conf.urls import url

def year_archive(request, year):
    year = int(year) # convert str to int
    # Get articles from database

def detail_view(request, article_id):
    pass

def edit_view(request, article_id):
    pass

def delete_view(request, article_id):
    pass

urlpatterns = [
    url(‘articles/(?P<year>[0-9]{4})/‘, year_archive),
    url(‘article/(?P<article_id>[a-zA-Z0-9]+)/detail/‘, detail_view),
    url(‘articles/(?P<article_id>[a-zA-Z0-9]+)/edit/‘, edit_view),
    url(‘articles/(?P<article_id>[a-zA-Z0-9]+)/delete/‘, delete_view),
]

考慮下這樣的兩個問題：

第一個問題，函數 year_archive 中year參數是字符串類型的，因此需要先轉化為整數類型的變量值，當然 year=int(year) 不會有諸如如TypeError或者ValueError的異常。那麽有沒有一種方法，在url中，使得這一轉化步驟可以由Django自動完成？

第二個問題，三個路由中 article_id 在業務中表示同一個字段，使用同樣的正則表達式，但是你需要寫三遍，當之後 article_id 規則改變後，需要同時修改三處代碼，那麽有沒有一種方法，只需修改一處即可？

在 Django2.0 中，可以使用 path 解決以上的兩個問題。

二 使用示例

這是一個簡單的例子：

1
2
3
4
5
6
7
8
9
10
 
from django.urls import path

from . import views

urlpatterns = [
    path(‘articles/2003/‘, views.special_case_2003),
    path(‘articles/<int:year>/‘, views.year_archive),
    path(‘articles/<int:year>/<int:month>/‘, views.month_archive),
    path(‘articles/<int:year>/<int:month>/<slug>/‘, views.article_detail),
]

基本規則：

  • 使用尖括號(<>)從url中捕獲值。
  • 捕獲值中可以包含一個轉化器類型（converter type），比如使用 <int:name> 捕獲一個整數變量。若果沒有轉化器，將匹配任何字符串，當然也包括了 / 字符。
  • 無需添加前導斜杠。

以下是根據 2.0官方文檔 而整理的示例分析表：

請求URL匹配項視圖函數調用形式
/articles/2005/03/ 第3個 views.month_archive(request, year=2005, month=3)
/articles/2003/ 第1個 views.special_case_2003(request)
/articles/2003 無 -
/articles/2003/03/building-a-django-site/ 第4個 views.article_detail(request, year=2003, month=3, slug=”building-a-django-site”)

三 path轉化器

文檔原文是Path converters，暫且翻譯為轉化器。

Django默認支持以下5個轉化器：

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

四 自定義轉化器

4.1 定義

對於一些復雜或者復用的需要，可以定義自己的轉化器。轉化器是一個類或接口，它的要求有三點：

  • regex 類屬性，字符串類型

  • to_python(self, value) 方法，value是由類屬性 regex 所匹配到的字符串，返回具體的Python變量值，以供Django傳遞到對應的視圖函數中。

  • to_url(self, value) 方法，和 to_python 相反，value是一個具體的Python變量值，返回其字符串，通常用於url反向引用。

先看看默認的 IntConverter 和 StringConverter 是怎麽實現的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
class IntConverter:
    regex = ‘[0-9]+‘

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

    def to_url(self, value):
        return str(value)


class StringConverter:
    regex = ‘[^/]+‘

    def to_python(self, value):
        return value

    def to_url(self, value):
        return value

第二個例子，是自己實現的4位年份的轉化器。

1
2
3
4
5
6
7
8
 
class FourDigitYearConverter:
    regex = ‘[0-9]{4}‘

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

    def to_url(self, value):
        return ‘%04d‘ % value

4.2 註冊

使用register_converter 將其註冊到URL配置中：

1
2
3
4
5
6
7
8
9
10
11
 
from django.urls import register_converter, path

from . import converters, views

register_converter(converters.FourDigitYearConverter, ‘yyyy‘)

urlpatterns = [
    path(‘articles/2003/‘, views.special_case_2003),
    path(‘articles/<yyyy:year>/‘, views.year_archive),
    ...
]

五 使用正則表達式

如果上述的paths和converters還是無法滿足需求，也可以使用正則表達式，這時應當使用 django.urls.re_path函數。

在Python正則表達式中，命名式分組語法為 (?P<name>pattern) ，其中name為名稱， pattern為待匹配的模式。

之前的示例代碼也可以寫為：

1
2
3
4
5
6
7
8
9
10
 
from django.urls import path, re_path

from . import views

urlpatterns = [
    path(‘articles/2003/‘, views.special_case_2003),
    re_path(‘articles/(?P<year>[0-9]{4})/‘, views.year_archive),
    re_path(‘articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/‘, views.month_archive),
    re_path(‘articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[^/]+)/‘, views.article_detail),
]

這段代碼和之前的代碼實現了基本的功能，但是還是有一些區別：

  • 這裏的代碼匹配更加嚴格，比如year=10000在這裏就無法匹配。
  • 傳遞給視圖函數的變量都是字符串類型，這點和 url 是一致的。

無命名分組

一般來說，不建議使用這種方式，因為有可能引入歧義，甚至錯誤。

六 Import變動

django.urls.path 可以看成是 django.conf.urls.url 的增強形式。

為了方便，其引用路徑也有所變化，請註意下 urls 包路徑的變更，不再是 conf 的子包了，目前和 views 、conf 一樣，被認為是 Django 的核心組件。

1.X2.0備註
- django.urls.path 新增，url的增強版
django.conf.urls.include django.urls.include 路徑變更
django.conf.urls.url django.urls.re_path 異名同功能，url不會立即廢棄

七 代碼改寫

將“問題引入”一節的代碼使用新的path函數可以改寫如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
from django.urls import path, register_converter
from django.urls.converters import SlugConverter

class FourDigitYearConverter:
    regex = ‘[0-9]{4}‘

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

    def to_url(self, value):
        return ‘%04d‘ % value

register_converter(SlugConverter, ‘article_id‘)
register_converter(FourDigitYearConverter, ‘year‘)

def year_archive(request, year):
    print(type(year)) # <class ‘int‘>
    # Get articles from database

def detail_view(request, article_id):
    pass

def edit_view(request, article_id):
    pass

def delete_view(request, article_id):
    pass

urlpatterns = [
    path(‘articles/<year:year>/‘, year_archive),
    path(‘article/<article_id:article_id>/detail/‘, detail_view),
    path(‘articles/<article_id:article_id>/edit/‘, edit_view),
    path(‘articles/<article_id:article_id>/delete/‘, delete_view),
]

八 總結

第一，目前 路由（url）到視圖（View）的流程可以概括為四個步驟：

  1. url匹配
  2. 正則捕獲
  3. 變量類型轉化
  4. 視圖調用

Django2.0 和之前相比多了 變量類型轉化 這一步驟。

第二，新的path語法可以解決一下以下幾個場景：

  • 類型自動轉化
  • 公用正則表達式

問題描述可參考 “問題引入” 一節。

django2筆記:路由path語法

相關推薦

django2筆記:路由path語法

接收 tin 動態 官方 register min 什麽 新版本 syntax django2筆記:路由path語法 2017-09-25 | 編程 | 7595 1,907 9月23，Django 發布了2.0a1版本，這是一個 feature freeze

Scala學習筆記：重要語法特性

返回值 contains curried 路徑名 重復 continue 路徑 冒號 語句 1.變量聲明 Scala 有兩種變量， val 和 var val的值聲明後不可變，var可變val msg: String = "Hello yet again, world!"

Angular5學習筆記 - 路由管理（五）

.html 修改內容 註冊 out style 導航 name alt angular5 一、添加路由管理引用 打開src/app/app.module.ts文件 import {RouterModule} from ‘@angular/router‘; import {

java學習筆記之基礎語法（二）

讓其 實例 高效率 使用 個數 存儲 記錄 棧內存 數組 1.數組： 概念：同一種類型數據的集合，其實，數組就是一個容器 優點：可以方便的對其進行操作，編號從0開始，方便操作這些元素。 2，數組的格式 元素類型[]數組名=new 元素類型[數組元素個

sql查詢語句for xml path語法

sql查詢 多行 一行 logs for cnblogs AR 圖片 www 【原地址】 for xml path作用：將多行的查詢結果，根據某一些條件合並到一行。 例：現有一張表 執行下面語句 select Department, (SELECT

ASP.NET MVC 學習筆記-3.Razor語法

OS 及其 wid resources 日期 ext str oca 區分 　　Razor語法是一種嵌入在網頁中基於服務器的代碼的編程語法。使用Razor語法的網頁中包括兩個不同類型的內容：客戶端內容和服務器內容。客戶端內容是網頁中常用的內容，比如，HTML標記（元素）、C

ASP.NET MVC 學習筆記-2.Razor語法

包含 鏈接 完整 rdquo 復雜 per 幫助 完成後 ade 1. 表達式 表達式必須跟在“@”符號之後， 2. 代碼塊 代碼塊必須位於“@{}”中，並且每行代碼必須以“；

tensorflow學習筆記(1)-基本語法和前向傳播

pla oba -a 訓練 style lac 好的 ini 神經元 　　　　　　　　　　　　　　　　　tensorflow學習筆記（1） 　　（1）tf中的圖 　　 　　圖中就是一個計算圖，一個計算過程。

Django2.0路由層-URLconf

不能 開頭 功能 匹配模式 tail 順序 git 整數 IE DJango2.0路由層-URLconf URL配置(URLconf)就像Django 所支撐網站的目錄樹。 它的本質是URL與要為該URL調用的視圖函數之間的映射表； 對於客戶端發來的某個URL調用哪一段

django2.0關於path匹配路徑頁面刷新不出來的問題

turn adl 正則 ans efault perm bio url title 下面是官方文檔的內容，如果在urls.py中使用到正則匹配路徑（^$）的時候，就需要使用re_path,而不能使用path，不然頁面會顯示404錯誤， 如果未用到正則，那麽使用path即可。

VUE 學習筆記 三 模板語法

1.插值 a.文字 資料繫結最常見的形式就是使用“Mustache”語法 (雙大括號) 的文字插值 <span>Message: {{ msg }}</span> v-once 指令，你也能執行一次性地插值，當資料改變時，插值處的內容不會更新 <span

C++ 快速入門筆記：基本語法

資料型別 列舉型別 enum color { red, green, blue } colors; colors = blue; 預設情況下，第一個名稱的值是 0，後面的依次加 1。也可以自定初始值： enum color { red, green = 5, blue }

《iOS Drawing Practical UIKit Solutions》讀書筆記(四) —— Path Basics

貝瑟爾曲線 貝瑟爾曲線是在繪製路徑時，常用的方式。通過貝瑟爾曲線，我們可以繪製常規的矩形，橢圓，或弧線。同時，通過二次，三次貝瑟爾曲線，我們還可以繪製更加複雜的曲線。現在，我們就一起來看一下，貝爾瑟爾曲線在iOS繪圖中的應用。 UIBezierPath UIBezierPat

【JavaScript基礎筆記】基礎語法易錯點（語句、表示式、變數、IF語句結構、賦值和相等）

語句和表示式的區別在於，前者主要為了進行某種操作，一般情況下不需要返回值；後者則是為了得到返回值，一定會返回一個值。凡是 JavaScript 語言中預期為值的地方，都可以使用表示式。   變數提示：JavaScript 引擎的工作方式是，先解析程式碼，獲取所有被宣告的變數，然後再一行一行地執行

【開發筆記】swift語法小記

最近在開發一個swift專案，swift語法說真的有點怪，不像js抓過來就寫。開一篇文章記錄swift與眾不懂的語法。 swift中檔案的匯入 swift中只要用swift寫的類都不需要額外的import,但是使用OC中寫的庫的時候需要import guard關鍵字

Kotlin學習筆記1_基礎語法

1. What’s Kotlin? – 引自百度百科 Kotlin 是一個用於現代多平臺應用的靜態程式語言,由 JetBrains 開發。 Kotlin可以編譯成Java位元組碼，也可以編譯成Java

【學習筆記】HTML語法筆記

基本結構 HyperText Markup Language 超文字標記語言 超文字：通過建立連結，使訪問者簡潔從一頁面跳到另一頁面 標記：對文字進行註釋 <html> <head> //有關這個頁面的一些資訊

Scrapy 使用筆記之twisted語法錯誤問題

第一次使用Scrapy就遇到了一個twisted語法錯誤問題，按理說其實不應該這樣，下面記錄詳細的過程和解決方法 環境：windows10+Python3.7 1、建立scrapy專案 D:\PythonWorkerspace>scrapy startprojec

oracle筆記pl_sql基本語法記錄型別01

/* pl/sql 基本語法 記錄型別 */ /* 1.pl/sql基本的語法格式 2.記錄型別 type ... is record(,,,); 3.流程控制 3.1條件判斷(兩種) 方式1:if ... then elsif then ... else ..

Angular學習筆記-路由守衛

應用場景 只有當用戶已經登陸並擁有某些許可權時才能進入某些路由 一個有多個表單元件組成的嚮導，例如註冊流程，使用者只有在當前路由的元件中填寫了滿足要求的資訊才可以導航到下一個路由 當用戶未執行儲存操作而試圖離開當前導航時提醒使用者