本文深入討論asp.net mvc 框架的路徑選擇(routing)架構及一些定制方式,可以將其用于應用中的一些更高級的場(chǎng)景。
在這個(gè)系列的第一部分里,我們創(chuàng )建了一個(gè)電子商務(wù)網(wǎng)站,呈示了三類(lèi)URL:
我們通過(guò)創(chuàng )建象下面這樣一個(gè)ProductsController類(lèi)來(lái)處理這些URL:
在把上面這個(gè)類(lèi)加到我們的應用中后,asp.net mvc框架就會(huì )把進(jìn)來(lái)的URL自動(dòng)導向到我們的控制器上的適當的action方法來(lái)處理請求。
在今天的貼子里,我們將深入討論這個(gè)URL映射是如何發(fā)生的,以及探討我們可以在asp.net mvc框架中利用的更高級的路徑選擇(routing)場(chǎng)景。我還將示范你如何可以輕松地單元測試URL路徑選擇場(chǎng)景。
asp.net mvc 框架的URL路徑選擇系統都做些什么?
asp.net mvc 框架包括了一個(gè)很靈活的URL路徑選擇系統,它允許你在應用中定義URL映射規則。路徑選擇系統有2個(gè)主要目的:
把進(jìn)來(lái)的URL映射到應用,并把它們做導向,這樣,正確的Controller和Action方法執行來(lái)處理這些請求
構建可以用來(lái)回調Controllers/Actions的輸出到客戶(hù)端的URL(例如,表單提交, < a href=""> 鏈接, 和 AJAX 調用等等)
能夠使用URL映射規則來(lái)同時(shí)處理進(jìn)來(lái)的和輸出的URL場(chǎng)景給應用代碼添加了許多靈活性。這意味著(zhù),如果我們以后想改變應用的URL結構的話(huà)(譬如,把 /Products 改名為 /Catalog),我們可以修改應用層次的一套映射規則即可,而不需要改動(dòng)控制器或視圖模板中的任何代碼。
默認的asp.net mvc URL路徑選擇規則
在默認情形下,當你使用Visual Studio用asp.net mvc Web Application模板來(lái)創(chuàng )建一個(gè)新項目時(shí),它會(huì )往項目里添加一個(gè)asp.net Application類(lèi)。這是在Global.asax后臺代碼中實(shí)現的:
asp.net Application類(lèi)允許開(kāi)發(fā)人員處理應用啟動(dòng)/中止以及全局性的錯誤處理的邏輯。
默認的asp.net mvc項目模板自動(dòng)向該類(lèi)添加一個(gè)Application_Start方法,在其中注冊2條URL路徑選擇規則:
上面的第一條路徑選擇規則表示,asp.net mvc框架在默認情形下,在決定用哪個(gè)Controller類(lèi)來(lái)生成實(shí)例,調用哪個(gè)Action方法時(shí)(以及哪些需要傳入的參數時(shí)),應該使用"[controller]/[action]/[id]"的格式把URL映射到控制器上。
這個(gè)默認的路徑選擇規則就是為什么第一部分中我們的電子商務(wù)瀏覽例程中對URL /Products/Detail/3 的請求自動(dòng)調用我們的ProductsController類(lèi)的Detail方法,并且傳入3作為id參數值的原因:
上面的第二條路徑選擇規則,是用來(lái)對我們應用的根URL"Default.aspx"做特例處理的(當處理一個(gè)應用的根URL的請求時(shí),這個(gè)URL有時(shí)會(huì )被服務(wù)器代替"/"來(lái)傳入)。這個(gè)規則確保對我們應用的根"/Default.aspx"或"/"的請求,都會(huì )由HomeController類(lèi)(是在我們使用asp.net mvc Web Application項目模板生成一個(gè)新的應用時(shí),由Visual Studio自動(dòng)生成的控制器)里的Index() action方法處理。
理解Route實(shí)例
路徑選擇規則是通過(guò)向System.Web.mvc.RouteTable的Routes集合添加Route實(shí)例來(lái)注冊的。
Route類(lèi)定義了許多你可以用以配置映射規則的屬性。你可以通過(guò)“傳統的” .net 2.0屬性賦值的方式來(lái)設置這些屬性:
或者利用VS 2008的C#和VB編譯器中的新的對象初始化器特性,更簡(jiǎn)潔地設置屬性:
Route類(lèi)的Url屬性定義了應該用來(lái)評估一個(gè)路徑選擇規則是否適用于進(jìn)來(lái)的特定請求的Url匹配規則。它還定義了URL應該如何分割成(tokenized)不同的參數。URL中可替換的參數,是通過(guò) [參數名稱(chēng)] 的句法來(lái)定義的。就象在后文論及的那樣,我們并不限制于一套固定的“熟知”參數名稱(chēng),你可以在URL使用任何數目的任意參數。例如,我可以使用一個(gè)"/Blogs/[Username]/Archive/[Year]/[Month]/[Day]/[Title]"的URL規則把進(jìn)來(lái)的一個(gè)博客貼子的URL進(jìn)行分割,由mvc框架自動(dòng)分析成UserName,Year,Month,Day 和 Title參數,并把它們傳入我的控制器的action方法中。
Route類(lèi)上的Defaults屬性定義了一個(gè)默認值的字典,可以在進(jìn)來(lái)的URL并不包含某個(gè)指定的參數值的情形下使用。例如,在上面的URL映射例子中,我們定義了2個(gè)默認URL參數值,一個(gè)是"[action]" ,另一個(gè)是 "[id]"。這意味著(zhù),如果應用收到的是 /Products/ 這個(gè)URL,在默認情形下,路徑選擇系統會(huì )默認使用“Index”作為ProductsController的action的名稱(chēng)來(lái)執行。同樣地,如果指定了/Products/List/ ,那么就會(huì )使用null字符串作為"ID"參數的值。
Route類(lèi)的RouteHandler屬性定義了在URL被分割成參數,適當的路徑選擇規則被確定之后,應該用來(lái)處理請求的 IRouteHandler 實(shí)例。在上面的例子中,我們表示,我們想要使用System.Web.mvc.mvcRounteHandler類(lèi)來(lái)處理我們配置好的URL。這個(gè)額外的步驟存在的原因是,我們想確保URL路徑選擇系統可以同時(shí)用于mvc和非mvc請求的情形。有這個(gè)IRouteHandler接口,意味著(zhù),我們也能夠干凈地用于非mvc的請求(例如標準的WebForms,Astoria REST支持等等)。
Route類(lèi)還有一個(gè)Validation屬性,在本文的稍后我們會(huì )做討論。這個(gè)屬性允許我們指定一個(gè)路徑選擇規則匹配需要滿(mǎn)足的先決條件。例如,我們可以指定一個(gè)路徑選擇規則應該只適用于一個(gè)特定的HTTP動(dòng)詞(允許我們輕松地映射REST命令),或者我們可以對參數值使用正則表達式,來(lái)過(guò)濾一個(gè)路徑選擇規則是否匹配。
注:在asp.net mvc 框架的第一個(gè)公開(kāi)預覽版中,Route類(lèi)是不可以擴展的(它只是個(gè)數據類(lèi)),在下一個(gè)預覽版中,我們正在研究把它做成可擴展的,允許開(kāi)發(fā)人員添加特定場(chǎng)景的路徑類(lèi)(譬如,一個(gè)RestRoute子類(lèi))來(lái)干凈利索地添加新的語(yǔ)義和功能。
路徑規則的評估
當一個(gè)進(jìn)來(lái)的URL被asp.net mvc Web應用收到時(shí), asp.net mvc 框架會(huì )對RouteTable.Routes集合中的路徑選擇規則進(jìn)行評估,以決定適當的Controller來(lái)處理該請求。
asp.net mvc 框架是按RouteTable規則注冊的次序做評估來(lái)選擇使用哪個(gè)Controller的。將進(jìn)來(lái)的URL對每條Route規則做檢測,看它是否匹配,如果一個(gè)Route規則匹配的話(huà),那么該規則(以及相關(guān)聯(lián)的RouteHandler)將被用來(lái)處理進(jìn)來(lái)的請求(所有后面的規則都略過(guò)不計)。這意味著(zhù)你一般要按“最特殊到最不特殊(most specific to least specific,從特殊到一般)”的次序來(lái)組織你的路徑選擇規則。
【編輯推薦】
聯(lián)系客服