路由常用对象

RouteBase

用作表示 ASP.NET 路由的所有类的基类。        就是路由的一个基础抽象类。

//

// 摘要:

//     用作表示 ASP.NET 路由的所有类的基类。

[TypeForwardedFrom("System.Web.Routing, Version=3.5.0.0, Culture=Neutral, PublicKeyToken=31bf3856ad364e35")]

public abstract class RouteBase

{

    //

    // 摘要:

    //     初始化该类供继承的类实例使用。此构造函数只能由继承的类调用。

    protected RouteBase();

    //

    // 摘要:

    //     获取或设置一个值，该值指示 ASP.NET 路由操作是否应处理与现有文件匹配的 URL。

    //

    // 返回结果:

    //     如果 ASP.NET 路由操作处理所有请求（甚至包括与现有文件匹配的请求），则为 true；否则为 false。默认值为 false。

    public bool RouteExistingFiles { get; set; }

    //

    // 摘要:

    //     当在派生类中重写时，会返回有关请求的路由信息。

    //

    // 参数:

    //   httpContext:

    //     一个对象，封装有关 HTTP 请求的信息。

    //

    // 返回结果:

    //     一个对象，包含路由定义的值（如果该路由与当前请求匹配）或 null（如果该路由与请求不匹配）。

    public abstract RouteData GetRouteData(HttpContextBase httpContext);

    //

    // 摘要:

    //     当在派生类中重写时，会检查路由是否与指定值匹配，如果匹配，则生成一个 URL，然后检索有关该路由的信息。

    //

    // 参数:

    //   requestContext:

    //     一个对象，封装有关所请求的路由的信息。

    //

    //   values:

    //     一个包含路由参数的对象。

    //

    // 返回结果:

    //     一个对象（包含生成的 URL 和有关路由的信息）或 null（如果路由与 values 不匹配）。

    public abstract VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values);

}

是一个抽象类，里面两个抽象方法。（一般抽象类，抽象方法，虚方法  都是为了扩展用的           MVC最大的特点就是扩展，     1自身从原有的框架里面扩展来得。 2本身各个方面又支持扩展  ）

Route

提供用于定义路由及获取路由相关信息的属性和方法。       他继承了RouteBase。

public class Route : RouteBase

1、构造函数

//

// 摘要:

//     使用指定的 URL 模式和处理程序类初始化 System.Web.Routing.Route 类的新实例。

//

// 参数:

//   url:

//     路由的 URL 模式。

//

//   routeHandler:

//     处理路由请求的对象。

public Route(string url, IRouteHandler routeHandler);

//

// 摘要:

//     使用指定的 URL 模式、默认参数值和处理程序类初始化 System.Web.Routing.Route 类的新实例。

//

// 参数:

//   url:

//     路由的 URL 模式。

//

//   defaults:

//     用于 URL 中缺失的任何参数的值。

//

//   routeHandler:

//     处理路由请求的对象。

public Route(string url, RouteValueDictionary defaults, IRouteHandler routeHandler);

//

// 摘要:

//     使用指定的 URL 模式、默认参数值、约束和处理程序类初始化 System.Web.Routing.Route 类的新实例。

//

// 参数:

//   url:

//     路由的 URL 模式。

//

//   defaults:

//     要在 URL 不包含所有参数时使用的值。

//

//   constraints:

//     一个用于指定 URL 参数的有效值的正则表达式。

//

//   routeHandler:

//     处理路由请求的对象。

public Route(string url, RouteValueDictionary defaults, RouteValueDictionary constraints, IRouteHandler routeHandler);

//

// 摘要:

//     使用指定的 URL 模式、默认参数值、约束、自定义值和处理程序类初始化 System.Web.Routing.Route 类的新实例。

//

// 参数:

//   url:

//     路由的 URL 模式。

//

//   defaults:

//     要在 URL 不包含所有参数时使用的值。

//

//   constraints:

//     一个用于指定 URL 参数的有效值的正则表达式。

//

//   dataTokens:

//     传递到路由处理程序但未用于确定该路由是否匹配特定 URL 模式的自定义值。这些值会传递到路由处理程序，以便用于处理请求。

//

//   routeHandler:

//     处理路由请求的对象。

public Route(string url, RouteValueDictionary defaults, RouteValueDictionary constraints, RouteValueDictionary dataTokens, IRouteHandler

routeHandler);

url： 用于匹配路由和 URL 的模式。  ——就对应我们mvc中路由定义的url

defaults：他的类型为RouteValueDictionary，就是把Dictionary字典封装了一下。　　——就对应我们MVC中路由定义的defaults。但是mvc中的defaults是object类型的 （new { controller = "Home", action = "Index", id = UrlParameter.Optional }） ，源码中做了一次转化

    private static RouteValueDictionary CreateRouteValueDictionaryUncached(object values)

    {

        IDictionary<string, object> dictionary = values as IDictionary<string, object>;

        if (dictionary != null)

        {

            return new RouteValueDictionary(dictionary);

        }

        return TypeHelper.ObjectToDictionaryUncached(values);

    }

MVC中路由default转化成Route中default

routeHandler：这个比较重要类型为 IRouteHandler  它就是mvc中管道模型的handler。从这里看出mvc中的handler是从路由中注册进去的。这个下面讲到handler的时候在详细讲解。

constraints：他的类型类型为RouteValueDictionary，一个用于指定 URL 参数的有效值的正则表达式。　　——就适应我们MVC中的的constraints但是mvc中的是一个object类型（new { controller = "^H.*", action = "^Index$|^About$"},）源码中也做了一次转化，和defaults的转化方法是同一个。

dataTokens：他的类型也是RouteValueDictionary，定义：传递到路由处理程序但未用于确定该路由是否匹配特定 URL 模式的自定义值。这些值会传递到路由处理程序，以便用于处理请求。   这个直接上图其实就是MVC中的namespace（new[] { "URLsAndRoutes.AdditionalControllers" }）  命名空间就是非主流。  这个直接上图。

下面使我们MVC中路由定义。

public static void RegisterRoutes(RouteCollection routes)

{

    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

    //忽略Hand控制器下面的所有请求 不通过路由解析

    routes.IgnoreRoute("Hand/{*pathInfo}");

    routes.MapRoute(

        name: "Default",

        url: "{controller}/{action}/{id}",

        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }

    );

}

2、属性

//

// 摘要:

//     获取或设置为 URL 参数指定有效值的表达式的词典。

//

// 返回结果:

//     一个包含参数名称和表达式的对象。

public RouteValueDictionary Constraints { get; set; }

//

// 摘要:

//     获取或设置传递到路由处理程序但未用于确定该路由是否匹配 URL 模式的自定义值。

//

// 返回结果:

//     一个包含自定义值的对象。

public RouteValueDictionary DataTokens { get; set; }

//

// 摘要:

//     获取或设置要在 URL 不包含所有参数时使用的值。

//

// 返回结果:

//     一个包含参数名称和默认值的对象。

public RouteValueDictionary Defaults { get; set; }

//

// 摘要:

//     获取或设置处理路由请求的对象。

//

// 返回结果:

//     处理请求的对象。

public IRouteHandler RouteHandler { get; set; }

//

// 摘要:

//     获取或设置路由的 URL 模式。

//

// 返回结果:

//     用于匹配路由和 URL 的模式。

//

// 异常:

//   T:System.ArgumentException:

//     以下任一值：以 ~ 或 / 开头的值。包含 ? 字符的值。“全部捕捉”参数不在末尾。

//

//   T:System.Exception:

//     没有使用分隔符或文字常量分隔 URL 分段。

public string Url { get; set; }

这些属性都在构造函数中讲了。

3、方法

//

// 摘要:

//     返回有关所请求路由的信息。

//

// 参数:

//   httpContext:

//     一个对象，封装有关 HTTP 请求的信息。

//

// 返回结果:

//     一个对象，其中包含路由定义中的值。

public override RouteData GetRouteData(HttpContextBase httpContext);

//

// 摘要:

//     返回与路由关联的 URL 的相关信息。

//

// 参数:

//   requestContext:

//     一个对象，封装有关所请求的路由的信息。

//

//   values:

//     一个包含路由参数的对象。

//

// 返回结果:

//     一个包含与路由关联的 URL 的相关信息的对象。

public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values);

//

// 摘要:

//     确定参数值是否与该参数的约束匹配。

//

// 参数:

//   httpContext:

//     一个对象，封装有关 HTTP 请求的信息。

//

//   constraint:

//     用于测试 parameterName 的正则表达式或对象。

//

//   parameterName:

//     要测试的参数的名称。

//

//   values:

//     要测试的值。

//

//   routeDirection:

//     一个指定 URL 路由是否处理传入请求或构造 URL 的值。

//

// 返回结果:

//     如果参数值与约束匹配，则为 true；否则为 false。

//

// 异常:

//   T:System.InvalidOperationException:

//     constraint 不是包含正则表达式的字符串。

protected virtual bool ProcessConstraint(HttpContextBase httpContext, object constraint, string parameterName, RouteValueDictionary values,

RouteDirection routeDirection);

两个从父类RouteBase中抽象实现的。两外一个虚方法。（虚方法好呀，可以扩展）

public override RouteData GetRouteData(HttpContextBase httpContext);

返回有关所请求路由的信息。这个RouteData就是在MVC控制器中的RouteData，参数HttpContextBase也是MVC控制器中的HttpContext。下面是源码，就是创建一个RouteData然后把Route的信息赋值给他。

public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values);

返回与路由关联的 URL 的相关信息。

//

// 摘要:

//     表示有关路由和虚拟路径的信息，该路由和虚拟路径是在使用 ASP.NET 路由框架生成 URL 时产生的。

[TypeForwardedFrom("System.Web.Routing, Version=3.5.0.0, Culture=Neutral, PublicKeyToken=31bf3856ad364e35")]

public class VirtualPathData

{

    //

    // 摘要:

    //     初始化 System.Web.Routing.VirtualPathData 类的新实例。

    //

    // 参数:

    //   route:

    //     用于生成 URL 的对象。

    //

    //   virtualPath:

    //     生成的 URL。

    public VirtualPathData(RouteBase route, string virtualPath);

    //

    // 摘要:

    //     获取路由定义的自定义值集合。

    //

    // 返回结果:

    //     路由的自定义值集合。

    public RouteValueDictionary DataTokens { get; }

    //

    // 摘要:

    //     获取或设置用于创建 URL 的路由。

    //

    // 返回结果:

    //     一个对象，该对象表示与用于生成 URL 的参数匹配的路由。

    public RouteBase Route { get; set; }

    //

    // 摘要:

    //     获取或设置依据路由定义创建的 URL。

    //

    // 返回结果:

    //     依据路由生成的 URL。

    public string VirtualPath { get; set; }

}

VirtualPathData

参数RequestContext 这个就是HttpContext.Request.RequestContext

protected virtual bool ProcessConstraint(HttpContextBase httpContext, object constraint, string parameterName, RouteValueDictionary values, RouteDirection routeDirection);

确定参数值是否与该参数的约束匹配。

下图中画圈的  是   定义类必须实现才能检查某 URL 参数值是否对约束有效的协定。  他是一个接口

这个接口的实现有一下几个

以FloatRouteConstraint为例。其实主要做的是正则表达式验证，以及类型TryPase转化测试。

public class FloatRouteConstraint : IRouteConstraint

    {

        public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection)

        {

            if (parameterName == null)

            {

                throw Error.ArgumentNull("parameterName");

            }

            if (values == null)

            {

                throw Error.ArgumentNull("values");

            }

            object obj;

            if (!values.TryGetValue(parameterName, out obj) || obj == null)

            {

                return false;

            }

            if (obj is float)

            {

                return true;

            }

            string s = Convert.ToString(obj, CultureInfo.InvariantCulture);

            float num;

            return float.TryParse(s, NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite | NumberStyles.AllowLeadingSign | NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands | NumberStyles.AllowExponent, CultureInfo.InvariantCulture, out num);

        }

    }

RouteCollection

为 ASP.NET 路由操作提供路由的集合。

public class RouteCollection : Collection<RouteBase>

可以看出他是一个集合，我们用的类型一般为Route类，MVC注册路由里面使用的也是Route类型往集合中添加。

在MVC中有为期扩展了一些方法  扩展类public static class RouteCollectionExtensions（扩展方法中  在注册路由的时候把Handler也注册进去了）

RouteTable

存储应用程序的 URL 路由。

//

// 摘要:

//     存储应用程序的 URL 路由。

[TypeForwardedFrom("System.Web.Routing, Version=3.5.0.0, Culture=Neutral, PublicKeyToken=31bf3856ad364e35")]

public class RouteTable

{

    //

    // 摘要:

    //     初始化 System.Web.Routing.RouteTable 类的新实例。

    public RouteTable();

    //

        // 摘要:

        //     获取从 System.Web.Routing.RouteBase 类派生的对象的集合。

        //

        // 返回结果:

        //     包含集合中的所有路由的对象。

    public static RouteCollection Routes { get; }

}

TouteTable 里面有一个静态变量  public static RouteCollection Routes { get; }

RouteData

RouteData有别于以上几个类型，上面的类型都是在System.Web.dll程序集中的，而RouteData在System.Web.Mvc.dll中，是MVC中特有的，他在MVC的控制器中有一个变量。

//

// 摘要:

//     获取在 ASP.NET 路由确定路由是否匹配请求时，传递到路由处理程序但未使用的自定义值的集合。

//

// 返回结果:

//     一个包含自定义值的对象。

public RouteValueDictionary DataTokens { get; }

//

// 摘要:

//     获取或设置表示路由的对象。

//

// 返回结果:

//     一个表示路由定义的对象。

public RouteBase Route { get; set; }

//

// 摘要:

//     获取或设置处理所请求路由的对象。

//

// 返回结果:

//     一个处理路由请求的对象。

public IRouteHandler RouteHandler { get; set; }

//

// 摘要:

//     获取路由的 URL 参数值和默认值的集合。

//

// 返回结果:

//     一个对象，其中包含根据 URL 和默认值分析得出的值。

public RouteValueDictionary Values { get; }

//

// 摘要:

//     使用指定标识符检索值。

//

// 参数:

//   valueName:

//     要检索的值的键。

//

// 返回结果:

//     其键与 valueName 匹配的 System.Web.Routing.RouteData.Values 属性中的元素。

//

// 异常:

//   T:System.InvalidOperationException:

//     valueName 的值不存在。

public string GetRequiredString(string valueName);
路由注册过程以及Handler

1、管道模型中注册的module

控制器中写一个action


视图展示


运行显示module，以及handler

查看运行涉及到Module

2、UrlRoutingModule

定义：匹配定义的路由的 URL ，请求他是MVC框架的起点。       并且路由指定了MvcRouteHandler，最终的handler是MvcHandler。

路由的方法调用流程

上面用了很多虚方法，是为了扩展有用的。

Module注册的事件是PostResolveRequestCache。所以Handler的分配是在这个里面的，和webform不一样

源码中路由注册方法

MvcHandler到控制器

1、public class MvcHandler : IHttpAsyncHandler, IHttpHandler, IRequiresSessionState

主要是在下图步骤3中得到控制器实例，然后控制器执行Execute方法

2、public abstract class ControllerBase : IController

在ControllerBase中执行Execute方法。但是在Execute中又执行了ExcuteCore这个抽象方法，这样又必须找他的子类中怎么实现的，通过下面Controller继承过程我们需要在找Controller类

public abstract class Controller : ControllerBase, IActionFilter, IAuthenticationFilter, IAuthorizationFilter, IDisposable, IExceptionFilter, IResultFilter, IAsyncController, IController, IAsyncManagerContainer

3、这个是Controller类中的ExecuteCore执行过程。

当然这个执行过程一般的讲  是找到action名字，然后反射调用方法。复杂的讲还有请求协议（get post），方法重载等控制。

最新文章

  1. （转）JS模块化编程之AMD规范
  2. mysql字符编码集（乱码）问题解决
  3. AsyncTask异步交互
  4. 移除NDK方法
  5. C++输入输出流的重载
  6. 学生选课系统数据库SQL语句考试题
  7. 内容提供者 ContentResolver 数据库 示例 -1
  8. IO中手机旋转事件的传递
  9. ListView 分页 排序、编辑、插入和删除
  10. implemented loader.php
  11. JavaScript实现ZLOGO: 用语法树实现多层循环
  12. 分布式进阶(一)Windows 7下硬盘安装Ubuntu 14.04图文教程
  13. 微信公众号支付提示mch_id参数格式错误
  14. 【hdu 5217】Brackets
  15. python --github 刷题
  16. 添加AD RMS role时，提示密码不能被验证The password could not be validated
  17. 邮件收取客户端LumiSoft类库接收yahoo邮件的问题。
  18. PHP微信公共号授权，获取openid、unionid。
  19. Software Engineer’s path to the best annual performance review
  20. 如何更改tomcat7及以上版本内存设置

热门文章

  1. yyy
  2. LeetCode之打家劫舍
  3. React.createElement 与 JSX
  4. 对okhttp参数的一些思考
  5. ubuntu之路——day6(今天对数据集的建立有了更深的体会）
  6. 第06组 Alpha冲刺（3/6）
  7. Python将多张图片进行合并拼接
  8. 深入理解JS中&amp;&amp;和||
  9. centos sqlite3安装及简单命令
  10. C语言函数库分类