ASP.NET Core MVC 源码学习：Routing 路由

时间  2019-12-04 标签 asp.net asp core mvc 源码 学习 routing 路由

前言

最近打算抽时间看一下 ASP.NET Core MVC 的源码，特此把本身学习到的内容记录下来，也算是作个笔记吧。html

路由做为 MVC 的基本部分，因此在学习 MVC 的其余源码以前仍是先学习一下路由系统，ASP.NET Core 的路由系统相对于之前的 Mvc 变化很大，它从新整合了 Web Api 和 MVC。git

路由源码地址 ：https://github.com/aspnet/Routinggithub

路由（Routing）功能介绍

路由是 MVC 的一个重要组成部分，它主要负责将接收到的 Http 请求映射到具体的一个路由处理程序上，在MVC 中也就是说路由到具体的某个 Controller 的 Action 上。api

路由的启动方式是在ASP.NET Core MVC 应用程序启动的时候做为一个中间件来启动的，详细信息会在下一篇的文章中给出。数据结构

通俗的来讲就是，路由从请求的 URL 地址中提取信息，而后根据这些信息进行匹配，从而映射到具体的处理程序上，所以路由是基于URL构建的一个中间件框架。
路由还有一个做用是生成响应的的URL，也就是说生成一个连接地址能够进行重定向或者连接。app

路由中间件主要包含如下几个部分：框架

  • URL 匹配
  • URL 生成
  • IRouter 接口
  • 路由模板
  • 模板约束

Getting Started

ASP.NET Core Routing 主要分为两个项目，分别是 Microsoft.AspNetCore.Routing.Abstractions,Microsoft.AspNetCore.Routing。前者是一个路由提供各功能的抽象，后者是具体实现。async

咱们在阅读源码的过程当中，我建议仍是先大体浏览一下项目结构，而后找出关键类，再由入口程序进行阅读。ide

Microsoft.AspNetCore.Routing.Abstractions

大体看完整个结构以后，我可能发现了几个关键的接口，理解了这几个接口的做用后可以帮助咱们在后续的阅读中事半功倍。函数

IRouter

在 Microsoft.AspNetCore.Routing.Abstractions 中有一个关键的接口就是 IRouter:

public interface IRouter { Task RouteAsync(RouteContext context); VirtualPathData GetVirtualPath(VirtualPathContext context); }public interface IRouter { Task RouteAsync(RouteContext context); VirtualPathData GetVirtualPath(VirtualPathContext context); }

这个接口主要干两件事情，第一件是根据路由上下文来进行路由处理，第二件是根据虚拟路径上下文获取 VirtualPathData。

IRouteHandler

另一个关键接口是 IRouteHandler , 根据名字能够看出主要是对路由处理程序机型抽象以及定义的一个接口。

public interface IRouteHandler { RequestDelegate GetRequestHandler(HttpContext httpContext, RouteData routeData); } public interface IRouteHandler { RequestDelegate GetRequestHandler(HttpContext httpContext, RouteData routeData); }

它返回一个 RequestDelegate 的一个委托，这个委托可能你们比较熟悉了，封装了处理Http请求的方法，位于Microsoft.AspNetCore.Http.Abstractions 中，看过我以前博客的同窗应该比较了解。

这个接口中 GetRequestHandler 方法有两个参数，第一个是 HttpContext，就很少说了，主要是来看一下第二个参数 RouteData。

RouteData，封装了当前路由中的数据信息，它包含三个主要属性，分别是 DataTokens, Routers, Values。

DataTokens： 是匹配的路径中附带的一些相关属性的键值对字典。

Routers： 是一个 Ilist<IRouter> 列表，说明RouteData 中可能会包含子路由。

Values： 当前路由的路径下包含的键值。

还有一个 RouteValueDictionary, 它是一个集合类，主要是用来存放路由中的一些数据信息的，没有直接使用 IEnumerable<KeyValuePair<string, string>> 这个数据结构是应为它的内部存储转换比较复杂，它的构造函数接收一个 Object 的对象，它会尝试将Object 对象转化为本身能够识别的集合。

IRoutingFeature

我根据这个接口的命名一眼就看出来了这个接口的用途，还记得我在以前博客中讲述Http管道流程中得时候提到过一个叫 工具箱 的东西么，这个 IRoutingFeature 也是其中的一个组成部分。咱们看一下它的定义：

 public interface IRoutingFeature { RouteData RouteData { get; set; } } public interface IRoutingFeature { RouteData RouteData { get; set; } }

原来他只是包装了 RouteData，到 HttpContext 中啊。

IRouteConstraint

这个接口我在阅读的时候看了一下注释，原来路由中的参数参数检查主要是靠这个接口来完成的。

咱们都知道在咱们写一个 Route Url地址表达式的时候，有时候会这样写：Route("/Product/{ProductId:long}") , 在这个表达式中有一个 {ProductId:long} 的参数约束，那么它的主要功能实现就是靠这个接口来完成的。

 /// Defines the contract that a class must implement in order to check whether a URL parameter /// value is valid for a constraint. public interface IRouteConstraint { bool Match( HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection); } /// Defines the contract that a class must implement in order to check whether a URL parameter /// value is valid for a constraint. public interface IRouteConstraint { bool Match( HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection); }

Microsoft.AspNetCore.Routing

Microsoft.AspNetCore.Routing 主要是对 Abstractions 的一个主要实现，咱们阅读代码的时候能够从它的入口开始阅读。

RoutingServiceCollectionExtensions 是一个扩展ASP.NET Core DI 的一个扩展类，在这个方法中用来进行 ConfigService，Routing 对外暴露了一个 IRoutingBuilder 接口用来让用户添加本身的路由规则，咱们来看一下：

public static IApplicationBuilder UseRouter(this IApplicationBuilder builder, Action<IRouteBuilder> action) { //...略 // 构造一个RouterBuilder 提供给action委托宫配置 var routeBuilder = new RouteBuilder(builder); action(routeBuilder); //调用下面的一个扩展方法，routeBuilder.Build() 见下文 return builder.UseRouter(routeBuilder.Build()); } public static IApplicationBuilder UseRouter(this IApplicationBuilder builder, IRouter router) { //...略 return builder.UseMiddleware<RouterMiddleware>(router); } public static IApplicationBuilder UseRouter(this IApplicationBuilder builder, Action<IRouteBuilder> action) { //...略 // 构造一个RouterBuilder 提供给action委托宫配置 var routeBuilder = new RouteBuilder(builder); action(routeBuilder); //调用下面的一个扩展方法，routeBuilder.Build() 见下文 return builder.UseRouter(routeBuilder.Build()); } public static IApplicationBuilder UseRouter(this IApplicationBuilder builder, IRouter router) { //...略 return builder.UseMiddleware<RouterMiddleware>(router); }

routeBuilder.Build() 构建了一个集合 RouteCollection，用来保存全部的 IRouter 处理程序信息，包括用户配置的Router。

RouteCollection 自己也实现了 IRouter , 因此它也具备路由处理的能力。

Routing 中间件的入口是 RouterMiddleware 这个类，经过这个中间件注册到 Http 的管道处理流程中， ASP.NET Core MVC 会把它默认的做为其配置项的一部分，固然你也能够把Routing单独拿出来使用。

咱们来看一下 Invoke 方法里面作了什么，它位于RouterMiddleware.cs 文件中。

public async Task Invoke(HttpContext httpContext) { var context = new RouteContext(httpContext); context.RouteData.Routers.Add(_router); await _router.RouteAsync(context); if (context.Handler == null) { _logger.RequestDidNotMatchRoutes(); await _next.Invoke(httpContext); } else { httpContext.Features[typeof(IRoutingFeature)] = new RoutingFeature() { RouteData = context.RouteData, }; await context.Handler(context.HttpContext); } } public async Task Invoke(HttpContext httpContext) { var context = new RouteContext(httpContext); context.RouteData.Routers.Add(_router); await _router.RouteAsync(context); if (context.Handler == null) { _logger.RequestDidNotMatchRoutes(); await _next.Invoke(httpContext); } else { httpContext.Features[typeof(IRoutingFeature)] = new RoutingFeature() { RouteData = context.RouteData, }; await context.Handler(context.HttpContext); } }

首先，经过 httpContext 来初始化路由上下文（RouteContext），而后把用户配置的路由规则添加到路由上下文RouteData中的Routers中去。

接下来 await _router.RouteAsync(context) , 就是用到了 IRouter 接口中的 RouteAsync 方法了。

咱们接着跟踪 RouteAsync 这个函数，看其内部都作了什么？ 咱们又跟踪到了RouteCollection.cs 这个类：

咱们看一下 RouteAsync 的流程：

 public async virtual Task RouteAsync(RouteContext context) { var snapshot = context.RouteData.PushState(null, values: null, dataTokens: null); for (var i = 0; i < Count; i++) { var route = this[i]; context.RouteData.Routers.Add(route); try { await route.RouteAsync(context); if (context.Handler != null) { break; } } finally { if (context.Handler == null) { snapshot.Restore(); } } } } public async virtual Task RouteAsync(RouteContext context) { var snapshot = context.RouteData.PushState(null, values: null, dataTokens: null); for (var i = 0; i < Count; i++) { var route = this[i]; context.RouteData.Routers.Add(route); try { await route.RouteAsync(context); if (context.Handler != null) { break; } } finally { if (context.Handler == null) { snapshot.Restore(); } } } }

我以为这个类，包括函数设计的很巧妙，若是是个人话，我不必定可以想的出来，因此咱们经过看源码也可以学到不少新知识。

为何说设计的巧妙呢？ RouteCollection 继承了 IRouter 可是并无具体的对路由进行处理，而是经过循环来从新将路由上下文分发的具体的路由处理程序上。咱们来看一下他的流程：

一、为了提升性能，建立了一个RouteDataSnapshot 快照对象，RouteDataSnapshot是一个结构体，它存储了 Route 中的路由数据信息。

二、循环当前 RouteCollection 中的 Router，添加到 RouterContext里的Routers中，而后把RouterContext交给Router来处理。

三、当没有处理程序处理当前路由 snapshot.Restore() 从新初始化快照状态。

接下来就要看具体的路由处理对象了，咱们从 RouteBase 开始。

一、RouteBase 的构造函数会初始化 RouteTemplate, Name, DataTokens, Defaults.
Defaults 是默认配置的路由参数。

二、RouteAsync 中会进行一系列检查，若是没有匹配到URL对应的路由就会直接返回。

三、使用路由参数匹配器 RouteConstraintMatcher 进行匹配，若是没有匹配到，一样直接返回。

四、若是匹配成功，会触发 OnRouteMatched(RouteContext context)函数，它是一个抽象函数，具体实现位于 Route.cs 中。

而后，咱们再继续跟踪到 Route.cs 中的 OnRouteMatch，一块儿来看一下：

protected override Task OnRouteMatched(RouteContext context) { context.RouteData.Routers.Add(_target); return _target.RouteAsync(context); }protected override Task OnRouteMatched(RouteContext context) { context.RouteData.Routers.Add(_target); return _target.RouteAsync(context); }

_target 值得当前路由的处理程序，那么具体是哪一个路由处理程序呢？ 咱们一块儿探索一下。

咱们知道，咱们建立路由一共有MapRoute,MapGet,MapPost,MapPut,MapDelete,MapVerb... 等等这写方式，咱们分别对应说一下每一种它的路由处理程序是怎么样的，下面是一个示例：

 app.UseRouter(routes =>{ routes.DefaultHandler = new RouteHandler((httpContext) => { var request = httpContext.Request; return httpContext.Response.WriteAsync($""); }); routes .MapGet("api/get/{id}", (request, response, routeData) => {}) .MapMiddlewareRoute("api/middleware", (appBuilder) => appBuilder.Use((httpContext, next) => httpContext.Response.WriteAsync("Middleware!") )) .MapRoute( name: "AllVerbs", template: "api/all/{name}/{lastName?}", defaults: new { lastName = "Doe" }, constraints: new { lastName = new RegexRouteConstraint(new Regex("[a-zA-Z]{3}",RegexOptions.CultureInvariant, RegexMatchTimeout)) }); }); app.UseRouter(routes =>{ routes.DefaultHandler = new RouteHandler((httpContext) => { var request = httpContext.Request; return httpContext.Response.WriteAsync($""); }); routes .MapGet("api/get/{id}", (request, response, routeData) => {}) .MapMiddlewareRoute("api/middleware", (appBuilder) => appBuilder.Use((httpContext, next) => httpContext.Response.WriteAsync("Middleware!") )) .MapRoute( name: "AllVerbs", template: "api/all/{name}/{lastName?}", defaults: new { lastName = "Doe" }, constraints: new { lastName = new RegexRouteConstraint(new Regex("[a-zA-Z]{3}",RegexOptions.CultureInvariant, RegexMatchTimeout)) }); });

按照上面的示例解释一下，

MapRoute：使用这种方式的话，必需要给 DefaultHandler 赋值处理程序，不然会抛出异常，一般状况下咱们会使用RouteHandler类。

MapVerb： MapPost,MapPut 等等都和它相似，它将处理程序做为一个 RequestDelegate 委托提供了出来，也就是说咱们实际上在本身处理HttpContext的东西，不会通过RouteHandler处理。

MapMiddlewareRoute：须要传入一个 IApplicationBuilder 委托，实际上 IApplicationBuilder Build以后也是一个 RequestDelegate，它会在内部 new 一个 RouteHandler 类，而后调用的 MapRoute。

这些全部的矛头都指向了 RouteHandler ， 咱们来看看 RouteHandler 吧。

 public class RouteHandler : IRouteHandler, IRouter { // ...略 public Task RouteAsync(RouteContext context) { context.Handler = _requestDelegate; return TaskCache.CompletedTask; } } public class RouteHandler : IRouteHandler, IRouter { // ...略 public Task RouteAsync(RouteContext context) { context.Handler = _requestDelegate; return TaskCache.CompletedTask; } }

什么都没干，仅仅是将传入进来的 RequestDelegate 赋值给了 RouteContext 的处理程序。

最后，代码会执行到 RouterMiddleware 类中的 Invoke 方法的最后一行 await context.Handler(context.HttpContext)，这个时候开始调用Handler委托，执行用户代码。

总结

咱们来总结一下以上流程：
首先传入请求会到注册的 RouterMiddleware 中间件，而后它 RouteAsync 按顺序调用每一个路由上的方法。当一个请求到来的时候，IRouter实例选择是否处理已经设置到 RouteContext Handler 上的一个非空 RequestDelegate。若是Route已经为该请求设置处理程序，则路由处理会停止而且开始调用设置的Hanlder处理程序以处理请求。若是当前请求尝试了全部路由都没有找处处理程序的话，则调用next，将请求交给管道中的下一个中间件。

关于路由模板和参数约束源码处理流程就不一一说了，有兴趣能够直接看下源码。

联系我们 沪ICP备13005482号-10