2. 程式人生 > >django2.0 path方法

django2.0 path方法

阿新 • • 發佈：2018-10-31

轉自：https://kinegratii.github.io/2017/09/25/django2-url-path/

 

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.X 2.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.0 path方法

轉自：https://kinegratii.github.io/2017/09/25/django2-url-path/   9月23，Django 釋出了2.0a1版本，這是一個 feature freeze 版本，如果沒有什麼意外的話，2.0正式版不會再增加新的功能了

Django2.0 path和re_path使用

Django2.0釋出後，很多人都擁抱變化，加入了2的行列。但是和1.11相比，2.0在url的使用方面發生了很大的變化，下面介紹一下： 一、例項 先看一個例子： from django.urls import path from . import views urlpatterns = [

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

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

四【用django2.0來開發】後臺會員管理(二) ModelForm表單的使用方法以及數據驗證

第一步 根據 cor 默認 日期時間 return dig 最大 quest 上一節我們講完了ModelAdmin的使用, 但是在操作中也發現, 新增編輯會員時, 我們無法驗證數據是否正確, 比如 用戶名、手機號、郵箱都應該是唯一的 用戶名和密碼長度的驗證 編輯用戶信息時

Django2.0之中介軟體的執行方法

def make_middleware_decorator(middleware_class): def _make_decorator(*m_args, **m_kwargs):

hive-0.11.0安裝方法具體解釋

col home 模式 tables 文件 create time his 拷貝 先決條件： 1)java環境，須要安裝java1.6以上版本號 2)hadoop環境，Hadoop-1.2.1的安裝方法參考 hadoop-1.2.1安裝方法具體解釋 本

PhpStorm10.0破解方法

htm jin aid cbe 編輯 cnblogs 編輯器 html intel 你的指尖有改變世界的力量 1、首先沒有安裝環境的朋友請查看：https://jingyan.baidu.com/article/ce09321b7681012bfe858f7a.html 2

IIS 發布之後 您要找的資源已被刪除、已更名或暫時不可用。 404.0 解決方法

進行 2.0 應用程序 png ima 刪除 blog mage 正常 步驟一： 如圖，我發布網站後，在應用程序池中看到默認的.NetFreamork是2.0版本的，我把它改為4.0後 重新瀏覽網頁就正常了。 如果還是不行，那麽進行第二步， IIS 發布之後 您要找的

Django折騰日記(django2.0)

serve user model mod 之前 語言 rtp 數據庫的配置 use 新建項目 django-admin startproject mysite 運行 python manage.py runserver 創建一個應用 python ma

最強離線安裝MySQL_8.0.2方法

字符集 分享 例如 bsp 環境 install mysql latin1 輸入 最強離線安裝MySQL_8.0.2方法，一次就能安裝成功。 按照此方式，離線安裝MySQL五分鐘都花不到，節省了大量的寶貴時間。 前戲，假設你已經從MySQL官網中獲取了下面這個壓縮包：

python3.5下django2.0使用pymysql連接mysql

django pymysql 創建數據庫create database haha default charset=utf8;安裝pymysqlpip install PyMySQL應用中的setting.py設置如下import pymysql pymysql.install_as_MySQLdb()

用 Django2.0 做 簡單的BBS（前端用 Bootstrap）

pla car field 簽名 增加 bootstrap dropdown mar ins 實現目標： 開發首頁顯示BBS的標題和摘要，點擊BBS的標題可跳轉到BBS詳細頁面進行展示。 開發環境及開發工具： Python 3.6.3 Django 2.0 Pycharm

django2.0基礎

行數據 last tap -a tro args 文件 led 表單提交 一.安裝與項目的創建 1.安裝 　　pip install django 2.查看版本 　　python -m django --version 3.創建項目 　　django-admin start

python3.5+django2.0快速入門(一)

blog 最新版 settings lin cati 現在 http all 需要 因為這篇教程需要用到anaconda的一些操作，如果還不懂anaconda的操作的同學可以看下這篇文章python 入門學習之anaconda篇。 創建python3+的開發環境 直接在終端

python3.6+django2.0 一小時學會開發一套學員管理系統demo

lean pycharm 成了 ... ati etl $.ajax size static 1.在pycharm中新建project demo1 添加app01 點擊create按鈕完成新建 2.在demo項目目錄下新建目錄static，並在settings.py中追加代

webpack 4.0 配置方法以及錯誤解決

文件目錄 pts 版本 創建目錄 efault ebp 大堆 添加 安裝 選取一個空目錄來試驗 全局安裝webpack4.1之後 創建目錄 mkdir webpacktest && cd webpacktes 初始化package.json npm init

Django：Python3.6.2+Django2.0配置MySQL

cli database IT 添加 djang 合並 self. bsp 檢查 持續學習Django中。。。 Django默認使用的數據庫是python自帶的SQLlite3，但SQLlite並不適用於大型的項目，因此我將數據庫換成了MySQL，下面介紹下Django

Django2.0中URL的路由機制

式表 錯誤處理 body 個數字 格式化 兩種 ear 映射 IT Django2.0中URL的路由機制 路由是關聯url及其處理函數關系的過程。Django的url路由配置在settings.py文件中ROOT_URLCONF變量指定全局路由文件名稱。 Django的

win10，python3.6，django2.0.3,項目基本命令

clas reat data tar server shel bsh serve pos 1.django-admin startproject project_name（創建項目） 2.python manage.py startapp appname（創建應用） 3.p

django1.0和django2.0的基於正則表達式的url區別

正則 url django1.0 django2.0django1.0和django2.0的基於正則表達式的url區別