用於定義正則表示式的字串。正則表示式不區分大小寫。

一個用於實現 IRouteConstraint 介面且包含 Match 方法的物件。

通過使用正則表示式可以規定引數格式,比如controller引數只能為4位數字:

new { controller = @"\d{4}"}

通過第IRouteConstraint 介面目前可以限制請求的型別.因為System.Web.Routing中提供了HttpMethodConstraint類, 這個類實現了IRouteConstraint 介面. 我們可以通過為RouteValueDictionary字典物件新增鍵為"httpMethod", 值為一個HttpMethodConstraint物件來為路由規則新增HTTP 謂詞的限制, 比如限制一條路由規則只能處理GET請求:

httpMethod =  new HttpMethodConstraint(  "GET", "POST"  )

完整的程式碼如下:

            routes.MapRoute(
                "Default",                                              // Route name
                "{controller}/{action}/{id}",                           // URL with parameters
                new { controller = "Home", action = "Index", id = "" },  // Parameter defaults
                new { controller = @"\d{4}" , httpMethod = new HttpMethodConstraint( "GET", "POST" ) }
            );

當然我們也可以在外部先建立一個RouteValueDictionary物件在作為MapRoute的引數傳入, 這只是語法問題.

namespaces引數:

此引數對應Route.DataTokens屬性. 官方的解釋是:

獲取或設定傳遞到路由處理程式但未用於確定該路由是否匹配 URL 模式的自定義值。

我目前不知道如何使用. 請高手指點

2.MapRoute方法例項

下面通過例項來應用MapRoute方法. 對於一個網站,為了SEO友好,一個網址的URL層次不要超過三層:

localhost/{頻道}/{具體網頁}

其中域名第一層, 頻道第二層, 那麼最後的網頁就只剩下最後一層了. 如果使用預設例項中的"{controller}/{action}/{其他引數}"的形式會影響網站的SEO.

假設我們的網站結構如下:

下面以酒店頻道為例, 是我建立的Routing規則:

        public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            #region 酒店頻道部分
            // hotels/list-beijing-100,200-3
            routes.MapRoute(
                "酒店列表頁",
                "hotels/{action}-{city}-{price}-{star}",
                new { controller = "Hotel", action = "list", city = "beijing", price="-1,-1", star="-1" },
                new { city=@"[a-zA-Z]*",price=@"(\d)+\,(\d)+", star="[-1-5]"}
                );

            //hotels/所有匹配
            routes.MapRoute(
                "酒店首頁",
                "hotels/{*values}",
                new { controller = "Hotel", action = "default", hotelid = "" }
                );
            #endregion

            //網站首頁.
            routes.MapRoute(
                 "網站首頁",
                 "{*values}",
                 new { controller = "Home", action = "index"}
                 );  
        }

實現的功能:

(1)訪問 localhost/hotels/list-beijing-100,200-3 會訪問酒店頻道的列表頁,並傳入查詢引數

(2)訪問 localhost/hotels 下面的任何其他頁面地址, 都會跳轉到酒店首頁.

(3)訪問 localhost 下面的任何地址, 如果未匹配上面2條, 則跳轉到首頁.

簡單總結:

(1)Routing規則有順序(按照新增是的順序), 如果一個url匹配了多個Routing規則, 則按照第一個匹配的Routing規則執行.

(2)由於上面的規則, 要將具體頻道的具體頁面放在最上方, 將頻道首頁 和 網站首頁 放在最下方.

(3) {*values} 表示後面可以使任意的格式.

3.使用Route類

MapRoute方法雖然簡單, 但是他是本質也是通過建立Route類的例項, 為RouteCollection集合新增成員.

下載最新版本的MSDN-Visual Studio 20008 SP1, 已經可以找到Route類的說明.

建立一個Route類例項,最關鍵的是為以下幾個屬性賦值:

這些屬性除了RouteHandler以外, 其他的都對應MapRoute方法的引數.RouteHandler是實現了IRouteHandler介面的物件.關於此介面的作用在第五部分Routing深入解析中做講解.

五.Routing深入解析

對於一個一般開發人員來說, 上面的知識已經完全足夠你使用ASP.NET MVC時使用Routing了.

接下來的部分我將深入Routing的機制講解Routing的高階應用.但是因為是"高階應用", 加上這篇文章已經太長了, 再加上馬上今天就過去了, "每日一篇"的承諾一定要兌現的, 所以不會對所有細節進行講解. 或者也可以略過此部分.

Routing如何將請求傳遞給Controller?上面講解Routing作用的時候, 我們就分析出Routing會將請求傳遞給Controller, 但是Routing如何做的這部份工作我們卻看不到.關鍵在於MapRoute()這個方法封裝了具體的細節.

雖然MapRoute方法是RouteCollection物件的方法,但是卻被放置在System.Web.Mvc程式集中, 如果你的程式只引用了System.Web.Routing, 那麼RouteCollection物件是不會有MapRoute方法的. 但是如果你同又引用了System.Web.Mvc, 則在mvc的dll中為RouteCollection物件添加了擴充套件方法:

       public static void IgnoreRoute(this RouteCollection routes, string url);
        public static void IgnoreRoute(this RouteCollection routes, string url, object constraints);
        public static Route MapRoute(this RouteCollection routes, string name, string url);
        public static Route MapRoute(this RouteCollection routes, string name, string url, object defaults);
        public static Route MapRoute(this RouteCollection routes, string name, string url, string[] namespaces);
        public static Route MapRoute(this RouteCollection routes, string name, string url, object defaults, object constraints);
        public static Route MapRoute(this RouteCollection routes, string name, string url, object defaults, string[] namespaces);
        public static Route MapRoute(this RouteCollection routes, string name, string url, object defaults, object constraints, string[] namespaces);

RouteCollection是一個集合,他的每一項應該是一個Route物件. 但是我們使用MapRoute時並沒有建立這個物件, 這是因為當我們將MapRoute方法需要的引數傳入時, 在方法內部會根據引數建立一個Route物件:

        public static Route MapRoute(this RouteCollection routes, string name, string url, object defaults, object constraints, string[] namespaces) {
            if (routes == null) {
                throw new ArgumentNullException("routes");
            }
            if (url == null) {
                throw new ArgumentNullException("url");
            }

            Route route = new Route(url, new MvcRouteHandler()) {
                Defaults = new RouteValueDictionary(defaults),
                Constraints = new RouteValueDictionary(constraints)
            };

            if ((namespaces != null) && (namespaces.Length > 0)) {
                route.DataTokens = new RouteValueDictionary();
                route.DataTokens["Namespaces"] = namespaces;
            }

            routes.Add(name, route);

            return route;
        }

上面就是MapRoute方法的實現, 至於在建立Route物件時第二個引數是一個MvcRouteHandler, 它是一個實現了IRouteHandler介面的類. IRouteHandler十分簡單隻有一個方法:

IHttpHandler GetHttpHandler(RequestContext requestContext);

引數是一個RequestContext 類例項, 這個類的結構也很簡單:

    public class RequestContext
    {
        public RequestContext(HttpContextBase httpContext, RouteData routeData);

        public HttpContextBase HttpContext { get; }
        public RouteData RouteData { get; }
    }

其中的一個屬性RouteData就包含了Routing根據Url識別出來各種引數的值, 其中就有Controller和Action的值.

歸根結底, ASP.NET MVC最後還是使用HttpHandler處理請求. ASP.NET MVC定義了自己的實現了IHttpHandler介面的Handler:MvcHandler,  因為MvcRouteHandler的GetHttpHandler方法最後返回的就是MvcHandler. 

MvcHandler的建構函式需要傳入RequestContext 物件, 也就是傳入了所有的所有需要的資料, 所以最後可以找到對應的Controller和Action, 已經各種引數.

六.測試Routing

因為一個Url會匹配多個routing規則, 最後常常會遇到規則寫錯或者順序不對的問題.於是我們希望能夠看到Url匹配Routing的結果.

其中最簡單的辦法就是使用RouteDebug輔助類. 這個類需要單獨下載dll元件, 我將此元件的下載放在了部落格園上:

解壓縮後是一個DLL檔案, 將這個DLL檔案新增到專案中並且新增引用.

使用方法很簡單, 只需要在Application_Start方法中新增一句話:

RouteDebug.RouteDebugger.RewriteRoutesForTesting(RouteTable.Routes);

比如下面是我的示例中的程式碼:

        protected void Application_Start()
        {
            RegisterRoutes(RouteTable.Routes);
            RouteDebug.RouteDebugger.RewriteRoutesForTesting(RouteTable.Routes);
        }

現在你訪問任何URL, 都會出現RouteDebug頁面, 如下:

其中不僅有你的所有Routing規則, 還顯示了是否匹配.並且按照順序列出. 還有識別的引數列表.

當你不想測試Routing規則的時候則註釋掉這一段, 即可回覆跳轉到View物件上.

七.總結

本文講解了ASP.NET MVC中一個關鍵的元件:Routing的使用. System.Web.Routing在Framework3.5 SP1中已經整合, 也就是說雖然我們還沒有ASP.NET MVC的正式版, 但是Routing元件卻已經提早釋出了. 因為Routing是一個相對獨立的元件, 不僅能和ASP.NET MVC配額使用, 也可以用於任何需要URL路由的專案. 另外Routing的作用和Url重寫(Url Rewrite)是有區別的, 你會發現Routing和Url Rewrite相比其實很麻煩, 無論是新增規則還是傳遞引數.對UrlRewite感興趣的可以去尋找UrlRewrite.dll這個元件, 很簡單很強大, 有關兩者的異同以及如何使用UrlRewrite這裡不在多說了.

本文的示例下載地址: