ASP.NET Core的路由[3]:Router的创建者——RouteBuilder

在《注册URL模式与HttpHandler的映射关系》演示的实例中,我们总是利用一个RouteBuilder对象来为RouterMiddleware中间件创建所需的Router对象,接下来我们就着重来介绍这个对象。RouteBuilder是我们对所有实现了IRouteBuilder接口的所有类型以及对应对象的统称。[本文已经同步到《ASP.NET Core框架揭秘》之中]

目录 一、RouteBuilder 二、RouteCollection 三、多个Route共享同一个Handler 四、每个Route具有独立的Handler 五、扩展方法MapVerb

一、RouteBuilder

如下面的代码片段所示,RouteBuilder对Router对象的创建体现在它的Build方法上。除此之外,IRouteBuilder接口还定义了一系列属性,我们可以利用它们得到用来注册中间件的ApplicationBuilder和用来提供服务的ServiceProvider。我们可以将多个Router注册到RouteBuilder上,这些注册的Router保存在Routes(不是Routers)属性上,而DefaultHandler属性返回一个默认的Router。

1: public interface IRouteBuilder   2: {   3:     IApplicationBuilder      ApplicationBuilder { get; }   4:     IServiceProvider         ServiceProvider { get; }   5:     IRouter                  DefaultHandler { get; set; }   6:     IList<IRouter>           Routes { get; }   7:     8:     IRouter Build();   9: }

ASP.NET Core默认使用的是如下一个实现了IRouteBuilder的RouteBuilder类型。如下面的代码片段所示,它的属性ApplicationBuilder是调用构造函数时通过相应的参数指定的,作为服务提供者的ServiceProvider则直接来源于这个ApplicationBuilder对象。至于最为核心的Build方法,我们可以看出它返回的实际上是通过注册的Router对象创建的一个RouteCollection对象。

1: public class RouteBuilder : IRouteBuilder   2: {   3:     public IApplicationBuilder    ApplicationBuilder { get; }   4:     public IServiceProvider       ServiceProvider { get; }   5:     public IList<IRouter>         Routes { get; }   6:     public IRouter                DefaultHandler { get; set; }   7:     8:     public RouteBuilder(IApplicationBuilder applicationBuilder) : this(applicationBuilder, null){}   9:    10:     public RouteBuilder(IApplicationBuilder applicationBuilder, IRouter defaultHandler)  11:     {  12:         this.ApplicationBuilder     = applicationBuilder;  13:         this.ServiceProvider        = applicationBuilder.ApplicationServices;  14:         this.DefaultHandler         = defaultHandler;  15:         this.Routes                 = new List<IRouter>();  16:      }  17:    18:     public IRouter Build()  19:     {  20:         RouteCollection routes = new RouteCollection();  21:         foreach (IRouter router in this.Routes)  22:         {  23:             routes.Add(router);  24:         }  25:         return routes;  26:     }  27: }

二、RouteCollection

一个RouteCollection是一个特殊的Router,因为RouteCollection实现如下了如下这个IRouteCollection接口,后者最终实现了IRouter接口。一个RouteCollection对象实际上是对多个Router对象的封装,我们可以调用其Add方法添加封装的Router对象。

1: public interface IRouteCollection : IRouter   2: {   3:     void Add(IRouter router);   4: }

为了更能更好的认识RouteCollection,尤其是实现在它的RouteAsync方法中路由解析原理,我们定义了如下这么一个模拟的类型。如下面的代码片段所示,当RouteAsync方法被执行的时候,它会遍历每个注册的Router对象并将当前RouteContext上下文作为参数调用它们的RouteAsync方法,直到遇到第一个与当前请求相匹配的Router。由于只有路由规则与当前请求相匹配的Router才会去设置RouteContext的Handler,所以判断Router是否与当前请求匹配的方法很简单,那就是判断当前RouteContext的Handler属性是否为null。

1: public class RouteCollection : IRouteCollection   2: {   3:     private readonly List<IRouter> _routes = new List<IRouter>();   4:     5:     public void Add(IRouter router)   6:     {   7:         _routes.Add(router);   8:     }   9:    10:     public async Task RouteAsync(RouteContext context)  11:     {  12:         var snapshot = context.RouteData.PushState(null, values: null, dataTokens: null);  13:         foreach (var router in _routes)  14:         {  15:             context.RouteData.Routers.Add(router);  16:             try  17:             {  18:                 await router.RouteAsync(context);  19:                 if (null != context.Handler)  20:                 {  21:                     break;  22:                 }  23:             }  24:             finally  25:             {  26:                 if (null == context.Handler)  27:                 {  28:                     snapshot.Restore();  29:                 }  30:             }  31:         }  32:     }  33:     public IRouter this[int index]     => _routes[index];  34:     public int Count                   => _routes.Count;  35:     …  36: }

当整个路由解析流程完成之后,最终的RouteData的状态应该只与那个匹配的Router对象有关。换句话说,对于路由规则与当前请求不匹配的Router来说,针对它们的路由解析过程不应该“污染”最终的这个RouteData对象。为了达到这个目的,上面介绍的关于RouteData的快照机制被应用在这个RouteAsync方法上,上面所示的代码片段也体现了这一点。

由于RouteBuilder对RouterMiddleware中间件提供的Router对象实际上是一个RouteCollection对象,换句话说这其实是一个由多个Router对象组成的“路由表”。所谓的路由注册,本质上就是在这个路由表中添加相应的Router对象。RouteBuilder具有若干扩展方法帮助我们以一种很简洁的方式相这个路由表中添加Router,我们先来介绍如下这四个MapRoute重载。

1: public static class MapRouteRouteBuilderExtensions   2: {   3:     public static IRouteBuilder MapRoute(this IRouteBuilder routeBuilder, string name, string template);   4:     public static IRouteBuilder MapRoute(this IRouteBuilder routeBuilder, string name, string template, object defaults);   5:     public static IRouteBuilder MapRoute(this IRouteBuilder routeBuilder, string name, string template, object defaults, object constraints);   6:     public static IRouteBuilder MapRoute(this IRouteBuilder routeBuilder, string name, string template, object defaults, object constraints, object dataTokens);   7: }

三、多个Route共享同一个Handler

上述这四个MapRoute方法执行之后在路由表中添加的都是一个Route对象,这个Route对象的名称、路由模板、路由参数的默认值和约束和DataToken都是由对应的参数来指定的。我们知道Route对象其实是对另一个Router对象的封装,那么被封装的究竟是个怎样的Router呢?

如上图所示,被注册的Route对象封装的其实是同一个Router,它就是RouteBuilder的DefaultHandler属性返回的那个Router。换句话说,通过调用这些MapRoute方法注册的Route采用同一个处理器来处理被成功路由的请求。所以当我们采用调用这些方法注册路由的时候要求这个RouteBuilder的DefaultHandler属性作了正确的设置。如下所示的代码体现了最后一个MapRoute方法的实现。

1: public static IRouteBuilder MapRoute(this IRouteBuilder routeBuilder, string name, string template, object defaults, object constraints, object dataTokens)   2: {      3:     IInlineConstraintResolver requiredService = routeBuilder.ServiceProvider.GetRequiredService<IInlineConstraintResolver>();   4:     routeBuilder.Routes.Add(new Route(routeBuilder.DefaultHandler, name, template, new RouteValueDictionary(defaults), new RouteValueDictionary(constraints), new RouteValueDictionary(dataTokens), requiredService));   5:     return routeBuilder;   6: }

对于我们在《注册URL模式与HttpHandler的映射关系》演示的关于获取天气预报信息的实例来说,我们也可以按照如下的形式调用RouteBuilder的MapRoute方法来注册所需的两个路由。为了以“流畅”的链式编程的方式来甚至RouteBuilder的默认处理器,我们特意定义了如下这个扩展方法SetDefaultHandler。

1: new WebHostBuilder()   2:     .ConfigureServices(svcs => svcs.AddRouting())   3:     .Configure(app =>app.UseRouter(builder=>builder   4:         .SetDefaultHandler(WeatherForecast)   5:         .MapRoute("route1", @"weather/{city:regex(^0\d{{2,3}}$)}/{days:int:range(1,4)}")   6:         .MapRoute("route2", @"weather/{city:regex(^0\d{{2,3}}$)}/{@date}")))           7:     …   8:     9: public static IRouteBuilder SetDefaultHandler(this IRouteBuilder builder, RequestDelegate handler)  10: {  11:     builder.DefaultHandler = new RouteHandler(handler);  12:     return builder;  13: }

对于上面通过调用MapRoute方法注册的两个Route对象来说,我们将路由约束以内联的形式直接定义在路由模板上,其实我们也可以将路由约束作为MapRoute方法的参数。如下面的代码片段所示,我们以不仅以参数的形式设置了路由约束,还设置了路由参数的默认值。

1: IRouteConstraint city = new RegexRouteConstraint(@"^0\d{2,3}$");   2: IRouteConstraint days = new CompositeRouteConstraint(new IRouteConstraint[] { new IntRouteConstraint(), new RangeRouteConstraint(1, 4) });   3:     4: new WebHostBuilder()   5:     .ConfigureServices(svcs => svcs.AddRouting())   6:     .Configure(app => app.UseRouter(builder => builder   7:         .SetDefaultHandler(WeatherForecast)   8:         .MapRoute(   9:             name            : "route1",  10:             template        : @"weather/{city}/{days}",  11:             constraints     : new { city = city, days = days },  12:             defaults        : new {city="010", days=4 })  13:         .MapRoute(  14:             name           : "route2",  15:             template       : @"weather/{city}/{@date}",  16:             constraints    : new { city = city},  17:             defaults        :null)))  18:     …

四、每个Route具有独立的Handler

上面介绍的这四个MapRoute方法重载都会在路由表中注册一个Route对象,它们都将RouteBuilder的DefaultHandler属性返回的Router作为默认的处理器。如果每个注册的Route具有如下图所示各自不同的请求处理逻辑,我们又该如何注册这样的Route呢?

如果需要为注册的Route指定不同的处理器来处理成功路由的请求,我们可以调用RouteBuilder如下两个同样命名为MapRoute的扩展方法。如上所示的这两个MapRoute方法依然会在路由表中注册一个Route对象。调用第一个方法重载除了需要指定一个路由模板之外,还需要显式指定作为请求处理器的RequestDelegate对象。

1: public static class RequestDelegateRouteBuilderExtensions   2: {    3:     public static IRouteBuilder MapRoute(this IRouteBuilder builder, string template, RequestDelegate handler)   4:     {   5:         IInlineConstraintResolver resolver = builder.ServiceProvider.GetService< IInlineConstraintResolver>();   6:         Route route = new Route(new RouteHandler(handler), template, null, null, null, resolver);   7:         builder.Routes.Add(route);   8:         return builder;   9:     }  10:    11:     public static IRouteBuilder MapRoute(this IRouteBuilder builder, string template, Action<IApplicationBuilder> action)  12:     {  13:         IApplicationBuilder appBuilder = builder.ApplicationBuilder.New();  14:         action(appBuilder);  15:         return builder.MapRoute(template, appBuilder.Build());  16:     }  17: }

对于我们实例来说,如果我们使用WeatherForecastForDays方法来返回未来指定天数的天气信息,而使用另一个方法WeatherForecastForDate来返回指定日期的天气信息,那么我们就可以采用如下的形式调用上面这个MapRoute方法来注册所需的两个路由。

1: new WebHostBuilder()   2:     .ConfigureServices(svcs => svcs.AddRouting())   3:     .Configure(app => app.UseRouter(builder => builder   4:         .MapRoute(@"/weather/{city:^0\d{{2,3}}$}/{days:int:range(1,2)", WeatherForecastForDays)   5:         .MapRoute(@"/weather/{city:^0\d{{2,3}}$}/{*date}", WeatherForecastForDate)))   6:     …   7:     8: public static Task WeatherForecastForDays(HttpContext context);   9: public static Task WeatherForecastForDate(HttpContext context);

另一个MapRoute方法除了接收一个作为路由模板的字符串作为第一个参数之外,它的第二个参数是一个类型为Action<IApplicationBuilder>的委托对象。我们可以利用这个委托注册一个或者多个中间件,这些中间件最终会装换成一个RequestDelegate对象并作为注册Route的处理器。如下所示的代码片段展示了这个方法重载的实现。如果改用这个MapRoute方法来注册我们实例中所需的两个路由,我们可以采用如下的编程方式。

1: new WebHostBuilder()   2:     .ConfigureServices(svcs => svcs.AddRouting())   3:     .Configure(app => app.UseRouter(builder => builder   4:         .MapRoute(@"/weather/{city:^0\d{{2,3}}$}/{days:int:range(1,2)",appBuilder => appBuilder.Run(WeatherForecastForDays))   5:         .MapRoute(@"/weather/{city:^0\d{{2,3}}$}/{*date}", appBuilder=> appBuilder.Run(WeatherForecastForDate))))   6: …

五、扩展方法MapVerb

在《注册URL模式与HttpHandler的映射关系》演示的实例中,我们实际上是调用RouteBuilder的另一个名为MapGet的扩展方法来进行路由注册的,这个方法要求被成功路由的HTTP请求必须采用GET方法。除了针对GET请求,RouteBuilder还具有如下这些针对POST、PUT和DELETE请求的扩展方法(MapPost、MapPut和MapDelete)。

1: public static class RequestDelegateRouteBuilderExtensions   2: {      3:     public static IRouteBuilder MapGet(this IRouteBuilder builder, string template, RequestDelegate handler);   4:     public static IRouteBuilder MapGet(this IRouteBuilder builder, string template, Action<IApplicationBuilder> action);   5:     6:     public static IRouteBuilder MapPost(this IRouteBuilder builder, string template, RequestDelegate handler);   7:     public static IRouteBuilder MapPost(this IRouteBuilder builder, string template, Action<IApplicationBuilder> action);   8:     9:     public static IRouteBuilder MapPut(this IRouteBuilder builder, string template, RequestDelegate handler);  10:     public static IRouteBuilder MapPut(this IRouteBuilder builder, string template, Action<IApplicationBuilder> action);  11:    12:     public static IRouteBuilder MapDelete(this IRouteBuilder builder, string template, RequestDelegate handler);  13:     public static IRouteBuilder MapDelete(this IRouteBuilder builder, string template, Action<IApplicationBuilder> action);  14:    15:     public static IRouteBuilder MapVerb(this IRouteBuilder builder, string verb, string template, RequestDelegate handler);  16:     public static IRouteBuilder MapVerb(this IRouteBuilder builder, string verb, string template, Action<IApplicationBuilder> action);  17: }

实际上MapGet、MapPost、MapPut和MapDelete方法重载最终都会调用MapVerb方法,后者可以采用字符串的形式指定任意HTTP方法名称(比如“HEAD”和“OPTIONS”等)。这些方法针对HTTP方法的过滤是同一个类型为HttpMethodRouteConstraint的路由约束来实现的,它要求被路由的请求必须采用指定的方法。这两个MapVerb方法重载的实现原理体现在如下所示的代码片段中。

1: public static IRouteBuilder MapVerb(this IRouteBuilder builder, string verb, string template, RequestDelegate handler)   2: {   3:     string[] allowedMethods = new string[] { verb };   4:     Route item = new Route(new RouteHandler(handler), template, null, new RouteValueDictionary(new {    5:     httpMethod = new HttpMethodRouteConstraint(allowedMethods) }), null, GetConstraintResolver(builder));   6:     builder.Routes.Add(item);   7:     return builder;   8: }   9:    10: public static IRouteBuilder MapVerb(this IRouteBuilder builder, string verb,string template, Action<IApplicationBuilder> action)  11: {  12:     IApplicationBuilder builder2 = builder.ApplicationBuilder.New();  13:     action(builder2);  14:     return builder.MapVerb(verb, template, builder2.Build());  15: }

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏逆向技术

常见注入手法第四讲,SetWindowsHookEx全局钩子注入.以及注入QQ32位实战.

钩子回调根据SetWindowsHookEx参数1来设定的.比如如果我们设置WH_CBT 那么我们设置的回调函数就是CBT回调. 具体查询MSDN

1.5K2
来自专栏大内老A

ASP.NET MVC的Razor引擎:IoC在View激活过程中的应用

在《ASP.NET MVC的Razor引擎:RazorView》介绍BuildManagerCompiledView的时候,我们谈到默认使用的ViewPageA...

2049
来自专栏me的随笔

ASP.NET Core Middleware

中间件(Middleware)是ASP.NET Core中的一个重要特性。**所谓中间件就是嵌入到应用管道中用于处理请求和响应的一段代码**。ASP.NET C...

1293
来自专栏葡萄城控件技术团队

程序员级别鉴定书(.NET面试问答集锦)

作为一个.NET程序员,应该知道的不仅仅是拖拽一个控件到设计时窗口中。就像一个赛车手,一定要了解他的爱车 – 能做什么不能做什么。 本文参考Scott Hans...

3647
来自专栏kwcode

找到多个与名为“Home”的控制器匹配的类型的解决方案

 主地址:http://localhost:3412/Home/Index 区域地址:http://localhost:3412/T200/Home/Index...

47311
来自专栏Linux驱动

20.Linux-USB鼠标驱动

在上一章分析完USB总线驱动程序后, 接下来开始写一个USB驱动: 本节目的: 将USB鼠标的左键当作L按键,将USB鼠标的右键当作S按键,中键当作回车按键 参...

3718
来自专栏老九学堂

【面试】找工作必看的十道XML面试题

XML并不依赖于其他编程语言,与SQL一样是编程人员所必备的技能之一,因此在任何技术工作面试之前准备一些XML问题都是很有意义的。老九君为大家整合了十道有关XM...

4337
来自专栏熊二哥

快速入门系列--CLR--01基本概念

在.NET平台用C#这么久,自然会发现其版本很多,相应的概念也会很多,常常都是萌萌哒。而在实际工作中经常会遇到需要配置dll版本号,公钥token等场景,因而对...

1876
来自专栏me的随笔

ASP.NET MVC5中的Model验证

Model验证是ASP.NET MVC中的重要部分,它主要用于判断输入的数据类型及值是否符合我们设定的规则,这篇文章就介绍下ASP.NET MVC中Model验...

1372
来自专栏GreenLeaves

九、将cs文件快速的转换成可执行文件和响应文件(配置编译开关的文件)

1、将包含多个类型的源代码文件转换为可以部署的文件。有如下Program.cs的文件,代码如下: public sealed class Program...

3047

扫码关注云+社区

领取腾讯云代金券