Django中的 動態URL配置


舉個例子,一家在線書店會為每一本書提供一個URL,如:/books/243/、/books/81196/。

讓我們創建第三個視圖來顯示當前時間和加上時間偏差量的時間,設計是這樣的:  /time/plus/1/ 顯示當前時間+1個小時的頁面 /time/plus/2/ 顯示當前時間+2個小時的頁面 /time/plus/3/ 顯示當前時間+3個小時的頁面,以此類推。
 
新手可能會考慮寫不同的視圖函數來處理每個時間偏差量,URL配置看起來就象這樣:
 
urlpatterns = patterns('',
    ('^time/$', current_datetime),
    ('^time/plus/1/$', one_hour_ahead),
    ('^time/plus/2/$', two_hours_ahead),
    ('^time/plus/3/$', three_hours_ahead),
    ('^time/plus/4/$', four_hours_ahead),
)

   很明顯,這樣處理是不太妥當的。 不但有很多冗余的視圖函數,而且整個應用也被限制了只支持 預先定義好的時間段,2小時,3小時,或者4小時。 如果哪天我們要實現 5 小時,我們就 不得不再單獨創建新的視圖函數和配置URL,既重復又混亂。 我們需要在這里做一點抽象,提取 一些共同的東西出來。

關於漂亮URL的一點建議

  如果你有其它web平台的開發經驗(如PHP或Java),你可能會想:嘿!讓我們用查詢字符串參數吧! 就像/time/plus?hours=3里面的小時應該在查詢字符串中被參數hours指定(問號后面的是參數)。

  你可以 在Django里也這樣做 (如果你真的想要這樣做,我們稍后會告訴你怎么做), 但是Django的一個核心理念就是URL必須看起來漂亮。 URL /time/plus/3/ 更加清晰, 更簡單,也更有可讀性,可以很容易的大聲念出來,因為它是純文本,沒有查詢字符串那么 復雜。 漂亮的URL就像是高質量的Web應用的一個標志。

  Django的URL配置系統可以使你很容易的設置漂亮的URL,而盡量不要考慮它的反面 。

  那么,我們如何設計程序來處理任意數量的時差? 答案是:使用通配符(wildcard URLpatterns)。正如我們之前提到過,一個URL模式就是一個正則表達式。因此,這里可以使用d+來匹配1個以上的數字。

urlpatterns = patterns('',
    # ...
    (r'^time/plus/\d+/$', hours_ahead),
    # ...
)

  這里使用# …來表示省略了其它可能存在的URL模式定義。 (見上)

  這個URL模式將匹配類似 /time/plus/2/ , /time/plus/25/ ,甚至 /time/plus/100000000000/ 的任何URL。 更進一步,讓我們把它限制在最大允許99個小時, 這樣我們就只允許一個或兩個數字,正則表達式的語法就是 \d{1,2} :

(r'^time/plus/\d{1,2}/$', hours_ahead),

    在建造Web應用的時候,盡可能多考慮可能的數據輸入是很重要的,然后決定哪些我們可以接受。 在這里我們就設置了99個小時的時間段限制。

  另外一個重點,正則表達式字符串的開頭字母“r”。 它告訴Python這是個原始字符串,不需要處理里面的反斜杠(轉義字符)。 在普通Python字符串中,反斜杠用於特殊字符的轉義。比如n轉義成一個換行符。 當你用r把它標示為一個原始字符串后,Python不再視其中的反斜杠為轉義字符。也就是說,“n”是兩個字符串:“”和“n”。由於反斜杠在Python代碼和正則表達式中有沖突,因此建議你在Python定義正則表達式時都使用原始字符串。 從現在開始,本文所有URL模式都用原始字符串。10

  現在我們已經設計了一個帶通配符的URL,我們需要一個方法把它傳遞到視圖函數里去,這樣 我們只用一個視圖函數就可以處理所有的時間段了。 我們使用圓括號把參數在URL模式里標識 出來。 在這個例子中,我們想要把這些數字作為參數,用圓括號把 \d{1,2} 包圍起來:

(r'^time/plus/(\d{1,2})/$', hours_ahead),

如果你熟悉正則表達式,那么你應該已經了解,正則表達式也是用圓括號來從文本里 提取 數據的。2

最終的URLconf包含上面兩個視圖,如:

from django.conf.urls.defaults import *
from mysite.views import hello, current_datetime, hours_ahead

urlpatterns = patterns('',
    (r'^hello/$', hello),
    (r'^time/$', current_datetime),
    (r'^time/plus/(\d{1,2})/$', hours_ahead),
)

現在開始寫 hours_ahead 視圖。

hours_ahead 和我們以前寫的 current_datetime 很象,關鍵的區別在於: 它多了一個額外參數,時間差。 以下是view代碼:

from django.http import Http404, HttpResponse
import datetime

def hours_ahead(request, offset):
    try:
        offset = int(offset)
    except ValueError:
        raise Http404()
    dt = datetime.datetime.now() + datetime.timedelta(hours=offset)
    html = "<html><body>In %s hour(s), it will be %s.</body></html>" % (offset, dt)
    return HttpResponse(html)

讓我們逐行分析一下代碼:

視圖函數, hours_ahead , 有 兩個 參數: request 和 offset . (見上)

  request 是一個 HttpRequest 對象, 就像在 current_datetime 中一樣. 再說一次好了: 每一個視圖 總是 以一個 HttpRequest 對象作為 它的第一個參數。 (見上)

   offset 是從匹配的URL里提取出來的。 例如:如果請求URL是/time/plus/3/,那么offset將會是3;如果請求URL是/time/plus/21/,那么offset將會是21。請注意:捕獲值永遠都是字符串(string)類型,而不會是整數(integer)類型,即使這個字符串全由數字構成(如:“21”)。

(從技術上來說,捕獲值總是Unicode objects,而不是簡單的Python字節串,但目前不需要擔心這些差別。)

  在這里我們命名變量為 offset ,你也可以任意命名它,只要符合Python 的語法。 變量名是無關緊要的,重要的是它的位置,它是這個函數的第二個 參數 (在 request 的后面)。 你還可以使用關鍵字來定義它,而不是用 位置。

  我們在這個函數中要做的第一件事情就是在 offset 上調用 int() . 這會把這個字符串值轉換為整數。

請留意:如果你在一個不能轉換成整數類型的值上調用int(),Python將拋出一個ValueError異常。如:int(‘foo’)。在這個例子中,如果我們遇到ValueError異常,我們將轉為拋出django.http.Http404異常——正如你想象的那樣:最終顯示404頁面(提示信息:頁面不存在)。

  機靈的讀者可能會問: 我們在URL模式中用正則表達式(d{1,2})約束它,僅接受數字怎么樣?這樣無論如何,offset都是由數字構成的。 答案是:我們不會這么做,因為URLpattern提供的是“適度但有用”級別的輸入校驗。萬一這個視圖函數被其它方式調用,我們仍需自行檢查ValueError。 實踐證明,在實現視圖函數時,不臆測參數值的做法是比較好的。 松散耦合,還記得么?

  下一行,計算當前日期/時間,然后加上適當的小時數。 在current_datetime視圖中,我們已經見過datetime.datetime.now()。這里新的概念是執行日期/時間的算術操作。我們需要創建一個datetime.timedelta對象和增加一個datetime.datetime對象。 結果保存在變量dt中。

  這一行還說明了,我們為什么在offset上調用int()——datetime.timedelta函數要求hours參數必須為整數類型。

  這行和前面的那行的的一個微小差別就是,它使用帶有兩個值的Python的格式化字符串功能, 而不僅僅是一個值。 因此,在字符串中有兩個 %s 符號和一個以進行插入的值的元組: (offset, dt) 。

最終,返回一個HTML的HttpResponse。 如今,這種方式已經過時了。28

  在完成視圖函數和URL配置編寫后,啟動Django開發服務器,用瀏覽器訪問 http://127.0.0.1:8000/time/plus/3/ 來確認它工作正常。 然后是http://127.0.0.1:8000/time/plus/5/ 。再然后是 http://127.0.0.1:8000/time/plus/24/ 。最后,訪問 http://127.0.0.1:8000/time/plus/100/ 來檢驗URL配置里設置的模式是否只 接受一個或兩個數字;Django會顯示一個 Page not found error 頁面, 和以前看到的 404 錯誤一樣。 訪問URL http://127.0.0.1:8000/time/plus/ (沒有 定義時間差) 也會拋出404錯誤。

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM