在央浼进入Web API

[索引页]
[源码下载]

 

返璞归真 asp.net mvc (2) – 路由(System.Web.Routing)

  ASP.NET Web API 如若使用Web Host方式来过夜,在呼吁进入Web API
消息处理管道之前,就会用ASP.NET
本身的路由系统基于登记的路由表,解析出近来乞请的HttpController和Action的称呼,以及与对象Action方法有个别参数举行绑定的路由变量。

作者:webabcd

  ASP.NET路由系统包括两方面选用:

介绍
System.Web.Routing – 此命名空间提供用于 U奥迪Q7L
路由的类,通过此类能够应用不映射到大体文件的 U翼虎L

  • 注册路由映射,即注册路由模板和情理文件的合作关系,达成请求UGL450L地址和拍卖请求的大体地址的分离,可以抓实请求U劲客L可读性,SEO优化,灵活性,即请求U福睿斯L和拍卖请求的物理文件的更动互不影响
  • U汉兰达L生成,遵照登记的路由规则变化对应UCR-VL,使用这种UEnclaveL,刚好利用了路由注册的灵活性,能够使原本生成的U奥迪Q5L不中断,只需求修改路由布署的处理文件。
  • IRouteHandler –
    路由处理程序接口,自定义的路由处理程序都要贯彻那几个接口
  • RequestContext – 封装所请求的路由的相关消息和如今的 http 上下文音信
  • RouteData – 所请求的路由的连带信息
  • RouteCollection – 路由集合
  • RouteValueDictionary – 不区分轻重缓急写的 key/value 字典表
  • Route – 路由的连锁消息

一 、涉及的类及源码分析

示例
1、MyHandler.cs

  涉及的重中之重类型都在System.Web.Routing中,类及重庆大学成员和相互关系如下图:

图片 1using System;
图片 2using System.Collections.Generic;
图片 3using System.Linq;
图片 4using System.Web;
图片 5
图片 6using System.Web.Routing;
图片 7
图片 8namespace MVC.RoutingDemo
图片 9图片 10图片 11{
图片 12图片 13    /**//// <summary>
图片 14    /// 路由处理程序
图片 15    /// </summary>
图片 16    public class MyRouteHandler : IRouteHandler
图片 17图片 18    图片 19{
图片 20图片 21        /**//*
图片 22         * IRouteHandler – 路由处理程序接口,自定义的路由处理程序都要完毕这一个接口 
图片 23         *     该接口有2个措施 IHttpHandler GetHttpHandler(RequestContext requestContext)
图片 24         *     此方法须要重回3个拍卖该路由的 http 处理程序 (HttpHandler)
图片 25         * RequestContext – 封装所请求的路由的相关音讯和目前的 http 上下文信息
图片 26         *     RequestContext.HttpContext – 当前的 http 上下文音讯
图片 27         *     RequestContext.RouteData – 所请求的路由的相干音信
图片 28         */
图片 29
图片 30        public IHttpHandler GetHttpHandler(RequestContext requestContext)
图片 31图片 32        图片 33{
图片 34            return new MyHttpHandler(requestContext);
图片 35        }
图片 36    }
图片 37
图片 38图片 39    /**//// <summary>
图片 40    /// 自定义的 http 处理程序,由路由控制利用哪个 http 处理程序
图片 41    /// </summary>
图片 42    public class MyHttpHandler : IHttpHandler
图片 43图片 44    图片 45{
图片 46图片 47        public RequestContext RequestContext 图片 48{ get; private set; }
图片 49        
图片 50        public MyHttpHandler(RequestContext context)
图片 51图片 52        图片 53{
图片 54            RequestContext = context;
图片 55        }
图片 56
图片 57        public void ProcessRequest(HttpContext httpContext)
图片 58图片 59        图片 60{
图片 61图片 62            /**//*
图片 63             * RouteData – 所请求的路由的有关新闻
图片 64             *     RouteData.Values – 3个字典表(key – 路由参数;value – 路由值)
图片 65             *     RouteData.DataTokens – 自定义须要传递的多寡,也是多少个字典表
图片 66             *     RouteData.GetRequiredString(string key) – 获取钦赐的路由参数所对应的路由值
图片 67             */
图片 68
图片 69            httpContext.Response.Write(“相关参数为:<br />”);
图片 70            foreach (var dic in RequestContext.RouteData.Values)
图片 71图片 72            图片 73{
图片 74                httpContext.Response.Write(dic.Key + ” : ” + dic.Value + “<br />”);
图片 75            }
图片 76
图片 77            httpContext.Response.Write(“相关Token为:<br />”);
图片 78            foreach (var dic in RequestContext.RouteData.DataTokens)
图片 79图片 80            图片 81{
图片 82                httpContext.Response.Write(dic.Key + ” : ” + dic.Value + “<br />”);
图片 83            }
图片 84        }
图片 85
图片 86        public bool IsReusable
图片 87图片 88        图片 89{
图片 90图片 91            get 图片 92{ return false; }
图片 93        }
图片 94    }
图片 95
图片 96图片 97    /**//// <summary>
图片 98    /// 假如有 n 多的路由处理程序,为了有利于调用,减弱代码,大家能够将其写成一个 Factory 类,如下:
图片 99    /// </summary>
图片 100    public class RouteHandlerFactory : IRouteHandler
图片 101图片 102    图片 103{
图片 104        private string _name;
图片 105        public RouteHandlerFactory(string name)
图片 106图片 107        图片 108{
图片 109            _name = name;
图片 110        }
图片 111
图片 112        public IHttpHandler GetHttpHandler(RequestContext requestContext)
图片 113图片 114        图片 115{
图片 116            if (_name == “My”)
图片 117                return new MyHttpHandler(requestContext);
图片 118
图片 119            return new MyHttpHandler(requestContext);
图片 120        }
图片 121    }
图片 122
图片 123图片 124    /**//// <summary>
图片 125    /// 演示不经过路由,依照 web.config 中的 HttpHandler 相关布署,由此 HttpHandler 直接处理有关请球。具体安插见 Global.asax
图片 126    /// </summary>
图片 127    public class XXXHttpHandler : IHttpHandler
图片 128图片 129    图片 130{
图片 131        public XXXHttpHandler()
图片 132图片 133        图片 134{
图片 135
图片 136        }
图片 137
图片 138        public void ProcessRequest(HttpContext context)
图片 139图片 140        图片 141{
图片 142            context.Response.Write(context.Request.Url.ToString());
图片 143        }
图片 144
图片 145        public bool IsReusable
图片 146图片 147        图片 148{
图片 149图片 150            get 图片 151{ return false; }
图片 152        }
图片 153    }
图片 154}

   图片 155

2、Web.config

1、RouteBase

图片 156<?xml version=”1.0″?>
图片 157<configuration>
图片 158  <system.web>
图片 159    <httpHandlers>
图片 160
图片 161      <!–
图片 162      配置3个自定义的 HttpHandler,用于拍卖后缀名为 xxx 的页面
图片 163      假设不供给将 *.xxx 交给路由处理,而是直接让钦赐的 HttpHandler 处理,请参考 Global.asax 中的配置
图片 164      –>
图片 165      <add verb=”*” path=”*.xxx” type=”MVC.RoutingDemo.XXXHttpHandler” />
图片 166
图片 167    </httpHandlers>
图片 168    <httpModules>
图片 169      
图片 170      <!–
图片 171      UrlRoutingModule – 用于匹配 asp.net 应用程序中的路由的 http 请求
图片 172          该模块找到匹配路由后,会寻找 IRouteHandler 对象,以搜寻该路由,然后从该路由处理程序获取三个 IHttpHandler 对象,并将该对象用作当前呼吁的 http 处理程序
图片 173      –>
图片 174      <add name=”UrlRoutingModule” type=”System.Web.Routing.UrlRoutingModule, System.Web.Routing, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35″/>
图片 175      
图片 176    </httpModules>
图片 177  </system.web>
图片 178</configuration>
图片 179

  public abstract class RouteBase
  {
    private bool _routeExistingFiles = true;
    //依据路由模板与请求的UQashqaiL进行匹配,就算成功再次回到RouteData,不然再次来到NULL
    public abstract RouteData GetRouteData(HttpContextBase httpContext);
    //选择内定的路由变量列表(包括名称和值)与U哈弗L路由模板实行匹配,若匹配成功,再次来到完整UHighlanderL,不然重回NULL
    public abstract VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values);
    //表示是不是对现有的大体文件进行路由,暗中认可值为true,即经过地点“/employees/hr/index.aspx”
是访问不到 Index.aspx页面

3、Global.asax.cs

    //可是有时大家期待以物理文件路径方法来拜会对应的物理文件,能够安装该值为false,就足以访问到Index.aspx页面
    public bool RouteExistingFiles
    {
      get
      {
        return this._routeExistingFiles;
      }
      set
      {
        this._routeExistingFiles = value;
      }
    }
  }

图片 180using System;
图片 181using System.Collections.Generic;
图片 182using System.Linq;
图片 183using System.Web;
图片 184using System.Web.Mvc;
图片 185using System.Web.Routing;
图片 186
图片 187namespace MVC
图片 188图片 189图片 190{
图片 191    // Note: For instructions on enabling IIS6 or IIS7 classic mode, 
图片 192    // visit http://go.microsoft.com/?LinkId=9394801
图片 193
图片 194    public class MvcApplication : System.Web.HttpApplication
图片 195图片 196    图片 197{
图片 198        public static void RegisterRoutes(RouteCollection routes)
图片 199图片 200        图片 201{
图片 202图片 203            /**//* 路由方向:自上而下,查找到格外的就去处理,而不会三番五次往下做匹配 */
图片 204
图片 205图片 206            /**//*
图片 207             * RouteCollection – 路由集合
图片 208             *     RouteCollection.IgnoreRoute() – 内定的地点不由路由拍卖
图片 209             *     RouteCollection.Add() – 新增一个路由配置
图片 210             *     RouteCollection.MapRoute() – 映射一个路由(Add() 方法的简化版,内部会活动调用 MvcRouteHandler)
图片 211             */
图片 212
图片 213            // .asd 文件不走此路由
图片 214            routes.IgnoreRoute(“{resource}.axd/{*pathInfo}”);
图片 215            // .xxx 文件不走此路由
图片 216            routes.Add(new Route(“{resource}.xxx/{*pathInfo}”, new StopRoutingHandler()));
图片 217
图片 218
图片 219图片 220            /**//*
图片 221             * RouteValueDictionary – 不区分轻重缓急写的 key/value 字典表
图片 222             * Route – 路由的相干信息
图片 223             *     Route.Url – 路由的 url 匹配情势,{ } 内的为急需万分的路由参数名
图片 224             *     Route.Defaults – 路由参数的暗中认可值
图片 225             *     Route.RouteHandler – 路由相应的路由处理程序
图片 226             *     Route.DataTokens – 自定义要求传递的数据
图片 227             *     Route.Constraints – 约束参数值的卓有成效(能够是正则表明式(不区分轻重缓急写),也足以是兑现了 IRouteConstraint 的对象)
图片 228             */
图片 229
图片 230            Route route = new Route(
图片 231                “Routing/{parent}/{child}”,
图片 232
图片 233                // RouteValueDictionary – 能够吸收接纳叁个匿名对象为参数,属性名转换为 key, 属性值转换为 value
图片 234图片 235                new RouteValueDictionary(new 图片 236{ parent = “ria”, child = “silverlight”, controller = “Product”, action = “Index” }),
图片 237
图片 238                new RoutingDemo.MyRouteHandler()
图片 239            );
图片 240图片 241            route.DataTokens = new RouteValueDictionary(new 图片 242{ token1 = “abc”, token2 = “xyz” });
图片 243
图片 244            // HttpMethodConstraint – 达成了 IRouteConstraint 接口的类,用于约束 http 方法
图片 245图片 246            route.Constraints = new RouteValueDictionary(new 图片 247{ parent = @”^[a-zA-Z]+$”, httpMethod = new HttpMethodConstraint(“GET”) });
图片 248
图片 249            // 将路由添加进路由集合,名称能够随便设置,但不可能不唯一(也得以不安装路由名称)
图片 250            routes.Add(“MyRoutingDemo”, route);
图片 251            // routes.Add(route);
图片 252
图片 253
图片 254            // * – 路由也补助通配符
图片 255            // {*param} – 代表匹配任意值,在那之中路由参数名为 param
图片 256图片 257            routes.Add(new Route(“Wildcard/{*param}”, new RouteValueDictionary(new 图片 258{ controller = “Product”, action = “Index” }), new RoutingDemo.MyRouteHandler()));
图片 259
图片 260
图片 261            // MapRoute() 封装了 Add(), MapRoute() 内部会自动调用 MvcRouteHandler
图片 262            // 个中必供给有 controller 项和 action 项
图片 263            // 此中设置 namespaces 参数约等于 route.DataTokens[“Namespaces”] = namespaces;
图片 264            routes.MapRoute(
图片 265                “Products”,
图片 266                “ProductList/{pageIndex}”,
图片 267图片 268                new 图片 269{ controller = “Product”, action = “Index”, pageIndex = 0 }
图片 270            );
图片 271
图片 272            routes.MapRoute(
图片 273                “Default”,                                              // Route name
图片 274                “{controller}/{action}/{id}”,                           // URL with parameters
图片 275图片 276                new 图片 277{ controller = “Home”, action = “Index”, id = “” }  // Parameter defaults
图片 278            );
图片 279        }
图片 280
图片 281        protected void Application_Start()
图片 282图片 283        图片 284{
图片 285            RegisterRoutes(RouteTable.Routes);
图片 286
图片 287            // 调节和测试路由(供给 RouteDebug.dll),调用如下语句后,会在各样页面都体现详细的路由音信
图片 288            // RouteDebug.RouteDebugger.RewriteRoutesForTesting(RouteTable.Routes);
图片 289        }
图片 290    }
图片 291}
图片 292
图片 293
图片 294// 部署在 iis 应注意
图片 295// 配置通配符映射程序,类似如下地址
图片 296// C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll   
图片 297// 不要勾选“确认文件是还是不是留存”

2、Route

OK
[源码下载]

  RouteBase唯一子类,基于路由模板形式的路由匹配规则就定义在中间,向全局路由表中添加的正是二个Route对象。

  public class Route
: RouteBase
  {
    private const string HttpMethodParameterName =
“httpMethod”;
    private string _url;
    private ParsedRoute _parsedRoute;

    //构造函数,前面省略N个重载
    public Route(string url, RouteValueDictionary defaults, RouteValueDictionary constraints, RouteValueDictionary dataTokens, IRouteHandler routeHandler)
    {
      this.Url = url;
      this.Defaults =
defaults;
      this.Constraints =
constraints;
      this.DataTokens =
dataTokens;
      this.RouteHandler =
routeHandler;
    }

    //为路由模板中的变量以正则表明式的形武设定一些羁绊规范,Key为变量名,Value为正则表达式

    //假使有定义,匹配也要满意该约束
    public RouteValueDictionary Constraints { get; set; }
    //存款和储蓄额外的变量值
    public RouteValueDictionary DataTokens { get; set; }
    //路由变量暗许值,也不肯定要定义在路由模板中
    public RouteValueDictionary Defaults { get; set; }

    public IRouteHandler RouteHandler { get; set; }

    //路由模板,如/weather/{areacode}/{days},请求的U福睿斯L就是跟该模板实行匹配,/分割成八个段,每一个段又分变量(areacode,days)和字面量(weather)

    //匹配的七个规格,段数和路由模板相同,以及对应文本段内容也要平等,注,U哈弗L大小写不灵动
    public string Url
    {
      get
      {
        return this._url ?? string.Empty;
      }
      set
      {
        this._parsedRoute =
RouteParser.Parse(value);
        this._url = value;
      }
    }

    //依据路由模板与请求的U普拉多L举行匹配,若是成功重回RouteData,否则再次回到NULL

    public override RouteData GetRouteData(HttpContextBase httpContext)
    {
      RouteValueDictionary
values = this._parsedRoute.Match(httpContext.Request.AppRelativeCurrentExecutionFilePath.Substring(2)

  • httpContext.Request.PathInfo,         this.Defaults);
          if (values == null)
            return (RouteData)null;
          RouteData routeData =
    new RouteData((RouteBase)this, this.RouteHandler);
          if
    (!this.ProcessConstraints(httpContext, values, RouteDirection.IncomingRequest))
            return (RouteData)null;
          foreach (KeyValuePair<string, object> keyValuePair in values)
            routeData.Values.Add(keyValuePair.Key,
    keyValuePair.Value);
          if (this.DataTokens != null)
          {
            foreach (KeyValuePair<string, object> dataToken in this.DataTokens)
            routeData.DataTokens[dataToken.Key] =
    dataToken.Value;
          }
          return routeData;
        }

    //选拔钦赐的路由变量列表(包涵名称和值)与UCRUISERL路由模板进行匹配,若匹配成功,再次回到完整U科雷傲L,不然再次回到NULL
    public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values)
    {
      BoundUrl boundUrl =
this._parsedRoute.Bind(requestContext.RouteData.Values,
values, this.Defaults, this.Constraints);
      if (boundUrl == null)
        return (VirtualPathData)null;
      if (!this.ProcessConstraints(requestContext.HttpContext,
boundUrl.Values, RouteDirection.UrlGeneration))
        return (VirtualPathData)null;
      VirtualPathData
virtualPathData = new VirtualPathData((RouteBase)this, boundUrl.Url);
      if (this.DataTokens != null)
      {
        foreach (KeyValuePair<string, object> dataToken in this.DataTokens)
          virtualPathData.DataTokens[dataToken.Key] =
dataToken.Value;
      }
      return
virtualPathData;
    }

    //处理约束
    protected virtual bool ProcessConstraint(HttpContextBase httpContext, object constraint, string parameterName, RouteValueDictionary values, RouteDirection
      routeDirection)
    {
      IRouteConstraint
routeConstraint = constraint as
IRouteConstraint;
      if (routeConstraint !=
null)
        return
routeConstraint.Match(httpContext, this, parameterName, values,
routeDirection);
      string str = constraint
as string;
      if (str == null)
        throw new InvalidOperationException(string.Format((IFormatProvider)CultureInfo.CurrentUICulture,
                            System.Web.SR.GetString(“Route_ValidationMustBeStringOrCustomConstraint”),
new object[2]
      {
        (object)
parameterName,
        (object) this.Url
      }));
      object obj;
      values.TryGetValue(parameterName, out obj);
      return Regex.IsMatch(Convert.ToString(obj, (IFormatProvider)CultureInfo.InvariantCulture), “^(” + str + “)$”, RegexOptions.IgnoreCase |
              RegexOptions.CultureInvariant);
    }

    private bool ProcessConstraints(HttpContextBase httpContext, RouteValueDictionary values, RouteDirection routeDirection)
    {
      if (this.Constraints != null)
      {
        foreach (KeyValuePair<string, object> constraint in this.Constraints)
        {
          if (!this.ProcessConstraint(httpContext,
constraint.Value, constraint.Key, values, routeDirection))
          return false;
        }
      }
      return true;
    }

  }

  其它,RequestContext是对Http请求上下文和路由数据的卷入

  public class RequestContext
  {
    public RequestContext()
    {
    }

    public RequestContext(HttpContextBase httpContext, RouteData routeData)
    {
      if (httpContext ==
null)
        throw new ArgumentNullException(nameof(httpContext));
      if (routeData == null)
        throw new ArgumentNullException(nameof(routeData));
      this.HttpContext =
httpContext;
      this.RouteData =
routeData;
    }
    //请求上下文
    public virtual HttpContextBase HttpContext { get; set; }
    //路由数量
    public virtual RouteData RouteData { get; set; }
  }

3、RouteData

   RouteBase的GetRouteData方法的回来类型,用于封装解析后路由数据,其用RouteValueDictionary保存路由变量数据,RouteValueDictionary是—个字典,其
Key和 Value分别代表路由变量的名号和值,定义如下:

  public class RouteValueDictionary : IDictionary<string, object>

  {

  }

  public class RouteData
  {
    private RouteValueDictionary _values = new RouteValueDictionary();
    private RouteValueDictionary _dataTokens = new RouteValueDictionary();
    private IRouteHandler _routeHandler;

    public RouteData()
    {
    }

    public RouteData(RouteBase route, IRouteHandler routeHandler)
    {
      this.Route = route;
      this.RouteHandler =
routeHandler;
    }

    //是平素附加到Route上的自定义变量。
    public RouteValueDictionary DataTokens
    {
      get
      {
        return this._dataTokens;
      }
    }

    //解析它的 Route对象

    public RouteBase Route { get; set; }

    //提供最 终用
于处理请求的HttpHandIer对象(通过调用其GetHttpHandler方法获取)

    //能够在构造函数中传唱,也能够属性赋值
    public IRouteHandler RouteHandler
    {
      get
      {
        return this._routeHandler;
      }
      set
      {
        this._routeHandler
= value;
      }
    }

    //当中的路由变量是Route通过对请求U安德拉L的辨析拿到的
    public RouteValueDictionary Values
    {
      get
      {
        return this._values;
      }
    }

    //获取包蕴某个固定名称的变量值(如controller和action)对应的值
    public string GetRequiredString(string valueName)
    {
      object obj;
      if (this.Values.TryGetValue(valueName, out obj))
      {
        string str = obj as string;
        if (!string.IsNullOrEmpty(str))
          return str;
      }
      //不设有间接抛出十三分
      throw new InvalidOperationException(string.Format((IFormatProvider)CultureInfo.CurrentUICulture,
System.Web.SR.GetString(“RouteData_RequiredValue”), new         object[1]
          {
            (object)
valueName
          }));
    }
  }

  

  public interface IRouteHandler
  {
    IHttpHandler
GetHttpHandler(RequestContext
requestContext);
  }

4、VirtualPathData

  RouteBase的GeVirtualPathData方法的回来类型

  public class VirtualPathData
  {
    private RouteValueDictionary _dataTokens = new RouteValueDictionary();
    private string
_virtualPath;

    public VirtualPathData(RouteBase route, string virtualPath)
    {
      this.Route = route;
      this.VirtualPath =
virtualPath;
    }

    //来源于附加到 Route的
自定义变量集合
    public RouteValueDictionary DataTokens
    {
      get
      {
        return this._dataTokens;
      }
    }
    //当时分析的路由对象
    public RouteBase Route { get; set; }

    //完整虚拟路径
    public string VirtualPath
    {
      get
      {
        return
this._virtualPath ?? string.Empty;
      }
      set
      {
        this._virtualPath =
value;
      }
    }
  }

5、RouteTable
Routes RouteCollection

  全局路由表,即RouteTable类的静态属性Routes
类型为RouteCollection,通过内部的MapPageRoute方法开始展览路由映射

  public class RouteTable
  {
    private static RouteCollection _instance = new RouteCollection();

    public static RouteCollection Routes
    {
      get
      {
        return
RouteTable._instance;
      }
    }
  }

  RouteCollection 是Route的集合

  首要逻辑:

    RouteCollection的GetRouteData和GetVirtalPath方法会遍历集合中的每一个Route对象,并传到给定的参数调用同名方法直到找到一个卓越的Route(再次来到值不为Null),并赶回相应的RouteData和VirtaulPathData对象,要是集合中任何2个Route都不般配,最终回到NULL

  读写锁的采纳:

    RouteCollection那个集合对象不是线程安全的,使用ReaderWriterLockSlim举办线程读写同步,四个线程能够同时读,别的情状都不一样意,1个线程写时,别的的线程无法读或写,2个线程在读时候,别的线程只好读,无法写,即多少个线程只好读读,不能够读写、写写;

    在对聚集进行读取或更新时候,会调用GetReadLock和GetWriteLock方法得到读锁或写锁,再次回到的是内嵌私有类型:ReadLockDispsoabled和WriteLockDispsoabled,他们达成了接口IDispsoabled,是对ReaderWriterLockSlim的读写锁功效的包装。

  public class RouteCollection : Collection<RouteBase>
  {
    private Dictionary<string, RouteBase> _namedMap = new Dictionary<string, RouteBase>((IEqualityComparer<string>)StringComparer.OrdinalIgnoreCase);
    private ReaderWriterLockSlim _rwLock = new ReaderWriterLockSlim();

    public RouteCollection()
    {
    }

    public bool
RouteExistingFiles { get; set; }

    public void Add(string name, RouteBase item)
    {
      //…
      this.Add(item);
      if (!string.IsNullOrEmpty(name))
        this._namedMap[name] = item;
      Route route = item as
Route;
      if (route == null || route.RouteHandler == null)
        return;
    }

    //省略N个重载方法
    public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, RouteValueDictionary defaults, RouteValueDictionary
      constraints, RouteValueDictionary dataTokens)
    {
      if (routeUrl == null)
        throw new ArgumentNullException(nameof(routeUrl));
      //新建路由对象,IRouteHandler直接new PageRouteHandler
      Route route = new Route(routeUrl, defaults, constraints,
dataTokens, (IRouteHandler)new PageRouteHandler(physicalFile,
checkPhysicalUrlAccess));
      //添加进去
      this.Add(routeName,
(RouteBase)route);
      return route;
    }

    protected override void
ClearItems()
    {
      this._namedMap.Clear();
      base.ClearItems();
    }

    public IDisposable GetReadLock()
    {
      this._rwLock.EnterReadLock();
      return (IDisposable)new System.Web.Routing.RouteCollection.ReadLockDisposable(this._rwLock);
    }

    private RequestContext GetRequestContext(RequestContext requestContext)
    {
      if (requestContext !=
null)
        return
requestContext;
      HttpContext current =
HttpContext.Current;
      if (current == null)
        throw new InvalidOperationException(System.Web.SR.GetString(“RouteCollection_RequiresContext”));
      return new RequestContext((HttpContextBase)new HttpContextWrapper(current), new RouteData());
    }

    private bool
IsRouteToExistingFile(HttpContextBase httpContext)
    {
      string executionFilePath
= httpContext.Request.AppRelativeCurrentExecutionFilePath;
      if (!(executionFilePath
!= “~/”) || this.VPP == null)
        return false;
      if (!this.VPP.FileExists(executionFilePath))
        return
this.VPP.DirectoryExists(executionFilePath);
      return true;
    }

    public RouteData GetRouteData(HttpContextBase httpContext)
    {
      …
      using (this.GetReadLock())
      {
        //遍历集合中拥有RouteBase,并调用其GetRouteData方法,找到了就当下赶回
        foreach (RouteBase routeBase in (Collection<RouteBase>)this)
        {
          RouteData
routeData = routeBase.GetRouteData(httpContext);
          if (routeData !=
null)
          {
            if
(!routeBase.RouteExistingFiles)
            {
              if
(!flag2)
                flag1 = this.IsRouteToExistingFile(httpContext);
              if
(flag1)
                return (RouteData)null;
            }
            return
routeData;
          }
        }
      }
      return (RouteData)null;
    }

    public VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values)
    {
      requestContext = this.GetRequestContext(requestContext);
      using (this.GetReadLock())
      {
        //遍历集合中负有RouteBase,并调用其GetVirtualPath方法,找到了就马上重返
        foreach (RouteBase routeBase in (Collection<RouteBase>)this)
        {
          VirtualPathData
virtualPath = routeBase.GetVirtualPath(requestContext, values);
          if (virtualPath
!= null)
          {
            virtualPath.VirtualPath =
this.NormalizeVirtualPath(requestContext, virtualPath.VirtualPath);
            return
virtualPath;
          }
        }
      }
      return (VirtualPathData)null;
    }

    public VirtualPathData GetVirtualPath(RequestContext requestContext, string name, RouteValueDictionary values)
    {
      requestContext = this.GetRequestContext(requestContext);
      if (string.IsNullOrEmpty(name))
        return this.GetVirtualPath(requestContext,
values);
      RouteBase routeBase;
      bool flag;
      using (this.GetReadLock())
        flag = this._namedMap.TryGetValue(name, out routeBase);
      if (flag)
      {
        VirtualPathData
virtualPath = routeBase.GetVirtualPath(requestContext, values);
        if (virtualPath ==
null)
          return (VirtualPathData)null;
        virtualPath.VirtualPath =
this.NormalizeVirtualPath(requestContext, virtualPath.VirtualPath);
        return
virtualPath;
      }
      throw new ArgumentException(string.Format((IFormatProvider)CultureInfo.CurrentUICulture,
System.Web.SR.GetString(“RouteCollection_NameNotFound”), new         object[1]
        {
          (object) name
        }), nameof(name));
     }

    public IDisposable GetWriteLock()
    {
      this._rwLock.EnterWriteLock();
      return (IDisposable)new System.Web.Routing.RouteCollection.WriteLockDisposable(this._rwLock);
    }

    //忽略路由
    public void Ignore(string url)
    {
      this.Ignore(url, (object)null);
    }

    public void Ignore(string url, object constraints)
    {
      if (url == null)
        throw new ArgumentNullException(nameof(url));
      System.Web.Routing.RouteCollection.IgnoreRouteInternal ignoreRouteInternal =
new System.Web.Routing.RouteCollection.IgnoreRouteInternal(url);
      RouteValueDictionary
routeValueDictionary = new RouteValueDictionary(constraints);
      ignoreRouteInternal.Constraints = routeValueDictionary;
      this.Add((RouteBase)ignoreRouteInternal);
    }

    protected override void
InsertItem(int index, RouteBase item)
    {
      if (item == null)
        throw new ArgumentNullException(nameof(item));
      if (this.Contains(item))
        throw new ArgumentException(string.Format((IFormatProvider)CultureInfo.CurrentCulture,
System.Web.SR.GetString(“RouteCollection_DuplicateEntry”), new           object[0]),
nameof(item));
      base.InsertItem(index,
item);
    }

    protected override void
RemoveItem(int index)
    {
      this.RemoveRouteName(index);
      base.RemoveItem(index);
    }

    private void
RemoveRouteName(int index)
    {
      RouteBase routeBase =
this[index];
      foreach (KeyValuePair<string, RouteBase> named in this._namedMap)
      {
        if (named.Value ==
routeBase)
        {
          this._namedMap.Remove(named.Key);
          break;
        }
      }
    }

    protected override void
SetItem(int index, RouteBase item)
    {
      if (item == null)
        throw new ArgumentNullException(nameof(item));
      if (this.Contains(item))
        throw new ArgumentException(string.Format((IFormatProvider)CultureInfo.CurrentCulture,
System.Web.SR.GetString(“RouteCollection_DuplicateEntry”), new           object[0]),
nameof(item));
      this.RemoveRouteName(index);
      base.SetItem(index,
item);
    }

    private class ReadLockDisposable : IDisposable
    {
      private ReaderWriterLockSlim _rwLock;

      public
ReadLockDisposable(ReaderWriterLockSlim rwLock)
      {
        this._rwLock =
rwLock;
      }

      void IDisposable.Dispose()
      {
        this._rwLock.ExitReadLock();
      }
    }

    private class WriteLockDisposable : IDisposable
    {
      private ReaderWriterLockSlim _rwLock;

      public
WriteLockDisposable(ReaderWriterLockSlim rwLock)
      {
        this._rwLock =
rwLock;
      }

      void IDisposable.Dispose()
      {
        this._rwLock.ExitWriteLock();
      }
    }

    private sealed class IgnoreRouteInternal : Route
    {
      public
IgnoreRouteInternal(string url)
        : base(url, (IRouteHandler)new StopRoutingHandler())
      {
      }

      public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary routeValues)
      {
        return (VirtualPathData)null;
      }
    }
  } 

6、IRouteConstraint

  除了用正则表达式对有些变量进行约束外,还能用一个兑现了IRouteConstraint接口的靶子对全体请求实行封锁

  public interface IRouteConstraint
  {
    bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection);
  }

二 、注册路由映射

一 、基本选择MapPageRoute方法

  注册路由映射大旨是在大局路由表RouteTable.Routes里添加2个Route对象,通过调用路由表的MapPageRoute方法,该办法能够传递各类有关参数,如前一节的源码

  public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, RouteValueDictionary defaults, RouteValueDictionary
      constraints, RouteValueDictionary dataTokens)

  能够钦点路由名称routeName,模板routeUrl,对应处理的大体文件physicalFile,是还是不是核查路由目标地址的U哈弗L授权,私下认可值defaults,约束constraints,附加到
Route的 自定义变量集合dataTokens

  如大家得以按上面传递参数:   

    var defaults = new RouteValueDictionary { { “areacode”, “010” }, { “days”, 2 }};

    //约束,正则表达式
    var constaints = new RouteValueDictionary { { “areacode”, @”0\d{2,3}” }, { “days”, @”[1-3]” } };

    //对变量默许值的辨证
    var dataTokens = new RouteValueDictionary { { “defaultCity”, “BeiJing” }, { “defaultDays”, 2 } };

    RouteTable.Routes.MapPageRoute(“default”, “{areacode}/{days}”,”~/weather.aspx”, false, defaults, constaints, dataTokens);

   由下边源码可见,会建立如下Route对象

    Route route = new Route(routeUrl, defaults, constraints,
dataTokens, (IRouteHandler)new PageRouteHandler(physicalFile,
checkPhysicalUrlAccess));

   IRouteHandler是new PageRouteHandler(physicalFile,
checkPhysicalUrlAccess)

贰 、自定义约束IRouteConstraint

  接下去,大家用持续自IRouteConstraint约束类来界定请求允许的法子   

    public class HttpMethodConstraint : IRouteConstraint
    {
      public HttpMethodConstraint(params string[] allowedMethods);

      public ICollection<string> AllowedMethods { get; }

      protected virtual bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection);
    }

  使用办法:

     { “httpMethod”, new HttpMethodConstraint(“POST”) } 

  当然,能够传四个

三 、直接路由物理文件(RouteExistingFiles)

  RouteCollection和RouteBase都有总体性RouteExistingFiles ,暗中同意值分别为
false和true,要成功匹配路由,要知足五个标准化

  两者RouteExistingFiles 都为true,Route
的USportageL模板和央浼UHighlanderL匹配,不然不会收获RouteData数据。

  如大家按守旧办法访问叁个物理文件http://myhost:1111/my.aspx,路由配置一样

  RouteTable.Routes.MapPageRoute(“default”, “{areacode}/{days}”,”~/my.aspx”, false, defaults, constaints, dataTokens);

  my.aspx页面会打字与印刷成功匹配后的路由(RouteData)数据,运转结果显示,就算成功匹配(days由暗许值),不过处理页面my.aspx没有显得路由数据。所以要设置

  RouteTable.Routes.RouteExistingFiles =
true;

四 、注册忽略路由(Ignore)

  IIS7.5以及在合龙方式下,全体请求都要进来ASP.NET管道,那么大家要过滤掉一部分css和js之类的乞请,不对那些请求举行路由,通过全局路由表RouteCollection的Ignore方法,如下语句

  RouteTable.Routes.Ignore(“css/{filename}.css/{*pathInfo}”);

⑤ 、路由登记第两种方法(Add方法)

  RouteTable.Routes.Add(new Route(“{areacode}/{days}”,defaults, constaints,
dataTokens,new PageRouteHandler(“~/my.aspx”, false ));

③ 、根据路由规则生成U奥迪Q5L

  就算用RouteTable.Routes.GetVirtualPath,通过路由配置生成 UGL450L
,好处是足以转移配置而无需担心在应用程序中开创的UENCOREL链接中断,上面是3个运用例子:

  private string
GetVirtualPathForRecipe(string
recipeName)

  {

    VirtualPathData pathData = 

      RouteTable.Routes.GetVirtualPath(
      null,
      ”Recipe”,
      new RouteValueDictionary { { “Name”, recipeName } });

    return pathData.VirtualPath;

  }  

  Recipe是路由名称,路由模板为 (/recipe/{name})
,new RouteValueDictionary { { “Name”, recipeName
}是传播的路由变量及其值

  var recipes =
    new RecipeRepository()
      .GetAllRecipeNames()
      .OrderBy(recipeName => recipeName)
      .Select(recipeName =>
        new
        {
          Name = recipeName,
          Url = GetVirtualPathForRecipe(recipeName)
        });

 肆 、怎么样获取最后处理请求的HttpHandler(UrlRoutingModule)

  HttpHandler是由以下接口得到的

  public interface IRouteHandler
  {
    IHttpHandler GetHttpHandler(RequestContext requestContext);
  }

  以前边源码,能够知道,路由注册时候就内定了PageRouteHandler作为IRouteHandler,其GetHttpHandler方法会重临处理physicalFile的IHttpHandler

  Route route = new Route(routeUrl, defaults, constraints,
dataTokens, (IRouteHandler)new PageRouteHandler(physicalFile,
checkPhysicalUrlAccess));

  那如曾几何时候让系统精通,处理当下恳请是用非凡Httphandler呢,利用拦截HttpModule来落实。UrlRoutingModule便是这些请求拦截器。定义如下:

  public class UrlRoutingModule : IHttpModule

  {

    public RouteCollection RouteCollection { get; set; }
    protected void Init(HttpApplication context)

    {
      context.PostResolveRequestCache += new EventHandler(this.OnPostResolveRequestCache);
    }
    void
OnPostResolveRequestCache( object o,
EventArgs e)

    {
      HttpContext context =
((HttpApplication)sender).Context;
      HttpContextBase
contextWrapper = new HttpContextWrapper(context);
      //从方今恳请获取路由解析后的数量RouteData
      var routeData = RouteCollection.GetRouteData
(contextWrapper);
      //封装RouteData对象和近期HttpRequest对象为requestContext
      var requestContext = new
RequestContext (context,
routeData);
      //使用当前RouteData对象中的RouteHander属性获取路由拍卖程序IHttpHander接口
      IHttpHandler httpHandler
= routeData.RouteHandler.GetHttpHandler (requestContext );
      context.Request.RequestContext = requestContext ;
      context.RemapHandler (httpHandler);

     }

  }

 

相关文章