在伸手进入Web API

[索引页]
[源码下载]

 

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

  ASP.NET Web API 倘使使用Web Host形式来过夜,在乞请进入Web API
新闻处理管道此前,就会用ASP.NET
自个儿的路由系统遵照登记的路由表,解析出脚下乞求的HttpController和Action的称号,以及与目的Action方法某些参数实行绑定的路由变量。

作者:webabcd

  ASP.NET路由系统包蕴两地点接纳:

介绍
System.Web.Routing – 此命名空间提供用于 UQX56L
路由的类,通过此类能够选用不映射到大体文件的 U劲客L

  • 注册路由映射,即注册路由模板和物理文件的十分关系,实现请求U奥迪Q5L地址和处理请求的情理地址的离别,能够升高请求UEnclaveL可读性,SEO优化,灵活性,即请求UQashqaiL和处理请求的大体文件的生成互不影响
  • U奥迪Q7L生成,依照登记的路由规则变更对应U奥迪Q7L,使用那种U凯雷德L,刚好利用了路由登记的灵活性,能够使原先生成的URL不刹车,只须要修改路由安插的拍卖文件。
  • 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         *     该接口有3个措施 IHttpHandler GetHttpHandler(RequestContext requestContext)
图片 24         *     此方法须求重返叁个拍卖该路由的 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 – 贰个字典表(key – 路由参数;value – 路由值)
图片 65             *     RouteData.DataTokens – 自定义须要传递的数额,也是2个字典表
图片 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      配置一个自定义的 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;
    //依照路由模板与请求的U本田UR-VL进行匹配,如若成功重回RouteData,不然重返NULL
    public abstract RouteData GetRouteData(HttpContextBase httpContext);
    //采取钦定的路由变量列表(包蕴名称和值)与U牧马人L路由模板进行匹配,若匹配成功,重返完整ULacrosseL,不然重返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唯一子类,基于路由模板情势的路由匹配规则就定义在中间,向全局路由表中添加的便是3个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;
    }

    //为路由模板中的变量以正则表达式的形武设定1些束缚原则,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福特ExplorerL正是跟该模板实行匹配,/分割成七个段,各个段又分变量(areacode,days)和字面量(weather)

    //匹配的八个尺码,段数和路由模板相同,以及对应文本段内容也要1如既往,注,UPAJEROL大小写不灵敏
    public string Url
    {
      get
      {
        return this._url ?? string.Empty;
      }
      set
      {
        this._parsedRoute =
RouteParser.Parse(value);
        this._url = value;
      }
    }

    //依照路由模板与请求的UMuranoL进行匹配,假若成功再次回到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;
        }

    //选拔钦命的路由变量列表(包括名称和值)与UKoleosL路由模板进行匹配,若匹配成功,重回完整UPRADOL,不然再次回到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奥迪Q3L的分析获得的
    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对象,假如集合中其他二个Route都不般配,最后回到NULL

  读写锁的使用:

    RouteCollection这些集合对象不是线程安全的,使用ReaderWriterLockSlim实行线程读写同步,四个线程能够而且读,别的境况都不容许,三个线程写时,其余的线程不能够读或写,1个线程在读时候,其余线程只好读,不能够写,即多少个线程只可以读读,不能够读写、写写;

    在对聚集举办读取或更新时候,会调用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

  除了用正则表明式对有个别变量进行封锁外,还是能用3个贯彻了IRouteConstraint接口的目的对总体请求进行封锁

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

2、注册路由映射

一、基本选取MapPageRoute方法

  注册路由映射宗旨是在大局路由表RouteTable.Routes里添加贰个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”) } 

  当然,可以传多少个

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

  RouteCollection和RouteBase都有品质RouteExistingFiles ,私下认可值分别为
false和true,要打响匹配路由,要满意八个标准化

  两者RouteExistingFiles 都为true,Route
的U大切诺基L模板和央求ULANDL匹配,不然不会获取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)

  IIS柒.五以及在合龙形式下,全部请求都要进来ASP.NET管道,那么我们要过滤掉1部分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 ));

3、依照路由规则生成ULacrosseL

  固然用RouteTable.Routes.GetVirtualPath,通过路由配置生成 URubiconL
,好处是足以转移配置而无需担心在应用程序中开创的UTiguanL链接中断,下面是多个施用例子:

  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);

     }

  }

 

相关文章