Microsoft.AspNetCore.Routing路由

最新推荐文章于 2023-08-27 19:08:34 发布
最新推荐文章于 2023-08-27 19:08:34 发布
阅读量2.3k 收藏 1
点赞数
分类专栏： .NET Core

Microsoft.AspNetCore.Routing路由

这篇随笔讲讲路由功能，主要内容在项目Microsoft.AspNetCore.Routing中，可以在GitHub上找到，Routing项目地址。

    路由功能是大家都很熟悉的功能，使用起来也十分简单，从使用的角度来说可讲的东西不多。不过阅读源码的过程的是个学习的过程，看看顶尖Coder怎么组织代码也是在提升自己。

    我们知道现在ASP.NET Core中所有用到的功能都是服务，那么Routing服务是什么时候被添加到依赖注入容器的呢？答案是在StartUp类的ConfigureServices方法中。如果我们随便新建的MVC 6的项目，在VS中模板会自动帮我们添加一些代码，在Startup类中的两个方法我们可以找到一下代码。

复制代码
复制代码 
        public void ConfigureServices(IServiceCollection services)
        {
            // Add framework services.
            // 省略其他框架服务
            services.AddMvc();//添加MVC服务
            // Add application services.
            //省略自定义应用服务
        }
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
        }
复制代码
复制代码

     上面两个StartUp类里的方法，一个是注册服务，一个使用服务。从它们调用的方法名上应该能区别出来，AddXXX的是注册服务，UseXXX的是使用服务。这里面用到的方法都是扩展方法，有关路由需要用到的服务都会在AddMvc()中注册，当然这个方法还会注册一大堆其他MVC框架需要用的方法。如果想追踪相关服务的添加语句的话：AddMvc()->AddMvcCore()->ConfigureDefaultServices()->AddRouting()，另外一条线是AddMvc()->AddMvcCore()->AddMvcCoreServices()->TryAddSingleton<MvcDefaultHandler>()。前者是添加与路由模板解析存储相关的服务，后者是处理请求路由的服务，包括请求路由与模板的配对，以及触发相应的Action等等。

     我想分别从两条线来解释路由(Routing)的工作流程。

  1. 一条是从开发者注册路由，框架进行解析存储的角度来解释，也就是从MapRoute()这个方法开始。
  2. 另外一条是从解析路由的角度，一个请求的路由如何被处理，然后Invoke相应的Action。

     为了解释清楚相关概念，我想先解释一下三个词：Route, Routing, Router。三个词都可以模糊地翻译为路由，但是这样太容易混淆了，懂英语的人应该能一眼就看出其中的不同。

  • Routing是统称，有关路由的总体概念，就可以以Routing来描述，比如我讲的这个项目就叫Routing，或者我们有个添加有关路由服务的方法，就会叫AddRouting()；
  • Route是用来描述某一个特定路由的名词，它有具体的数据项，比如说上面的代码我们向框架中添加了一个name是default的Route；它还是一个类名，这个类就是干Route应该干的事情：存储、解析数据之类的；
  • Router可以翻译为“路由者”带路党，是一种Handler的体现，用来处理请求的路由，比如MVC框架默认的MvcRouteHandler就是一个Router。

注册路由

     首先从MapRoute()方法说起。这个方法会在内部调用这些代码

复制代码
复制代码 
1             routeBuilder.Routes.Add(new Route(
2                 routeBuilder.DefaultHandler,
3                 name,
4                 template,
5                 new RouteValueDictionary(defaults),
6                 new RouteValueDictionary(constraints),
7                 new RouteValueDictionary(dataTokens),
8                 inlineConstraintResolver));
复制代码
复制代码

     RouteBuilder会在内部维护一个Route(s)的容器，上面的代码在往容器里面添加新的Route，如果我们用VS默认的模板，那么这里面name="default", template="{controller=Home}/{action=Index}/{id?}"，其他参数诸如像defaults，constraints什么的都是没有的。需要说明的是此时routeBuilder.DefaultHandler已经被设置为MvcDefaultHandler，这是在UseMvc()方法中被设置的。在Route类的构造过程中（RouteBase的构造函数中），template字符串会被解析，包括是不是参数名(parameter)啊，是不是字面值(literal)啊，约束是什么，默认值是什么都可以被解析出来。MVC6的路由和MVC5有一点不一样，默认值以及约束可以写在template里，而MVC5的约束和默认值只能再传递一个匿名类型进去：defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }。显然MVC6的路由简单的多，当然你也可以还用以前的方式传递默认值，没有问题。MVC6的这种方法内置默认值和约束的方式在之前的特性路由已经体现了，用来改进传统路由也在情理之中。MvcDefaultHandler会被赋给Route的_target字段，这个字段在未来请求来临时发挥功效。

     解析路由的过程就是一个字符串处理的过程，比较复杂，如果要全部讲解篇幅太长。如果做过LeetCode上一些字符串处理的题目的话，看起来会轻松一些，有兴趣的童鞋可以去深究源码。

     UseMvc()这个方法和路由有很大的关系，下面来看一下它的源码

复制代码
复制代码 
        public static IApplicationBuilder UseMvc(this IApplicationBuilder app, Action<IRouteBuilder> configureRoutes)
        {
            //省略了检查参数的代码...
            var routes = new RouteBuilder(app)
            {
                DefaultHandler = app.ApplicationServices.GetRequiredService<MvcRouteHandler>(),
            };

            configureRoutes(routes);
            routes.Routes.Insert(0, AttributeRouting.CreateAttributeMegaRoute(
                routes.DefaultHandler,
                app.ApplicationServices));

            return app.UseRouter(routes.Build());
        }
复制代码
复制代码

     configureRoutes(routes)就是上面解释的调用MapRoute()方法的一个Action委托。DefaultHandler在构造RouteBuilder时被设置为默认的MvcRouteHandler，如果我们想要使用其他Handler，可以模仿这个UseMvc()方法重新写一个拓展方法，传入你的Handler即可。注意下面那句代码：它向RouteBuilder.Routes中添加了用于处理特性路由的Route，并用Insert方法将其添加了到容器的起始位置，这说明特性路由要优先于传统路由。至于为什么要先添加传统路由，是因为开发者可以在传入的configureRoutes这个委托中指定自己的Handler，DefaultHandler有可能在configureRoutes(routes)这段代码中变了，所以特性路由的添加要晚于传统路由。

     RouteBuilder.Build()方法会生成一个包含当前Route的集合，这些Route携带了信息（包括传统路由被解析的参数，约束等以及特性路由的元数据等），在上面的例子中，这个容器就两个Route，一个特性路由，一个name="default"的传统路由。最后app.UseRouter会向ApplicationBuilder中添加一个类型为RouterMiddleware的中间件。此时整个有关路由的第一条工作流程就到此结束了。如果比较一下AddMvc()和UseMvc()会发现前一个方法关系到了非常多的服务，而后一个方法似乎只用到了有关路由的东西，这是因为服务的注册要一起完成，而使用服务可以即时拉取。当应用程序响应请求时，一开始只用到路由服务，假如请求匹配，才会用到有关Controller和Action的服务，到那时候再拉取即可。

     UseRouter()方法最终会调用ApplicationBuilder.Use()方法，RouterMiddleware的信息最终会以委托的方式存储在ApplicationBuilder中，有关这方面的流程可以参阅我之前的文章：Microsoft.AspNetCore.Hosting。

处理请求路由

    上面说到我们注册路由时，路由的信息在UseRouter()方法调用时是以Func<RequesetDelegate, RequestDelegate>方式存在。每一个中间件最初都是一种形态，利用这种方式，可以把在程序中用到的中间件构造成一种委托链，最后可以构造出一个跟使用顺序有关的RequestDelegate：即请求管道。Routing是请求管道中的一部分，假如请求到达routing区域，则相关的RequestDelegate就会被触发，利用反射构造出RouteMiddleware这个类，然后调用它的Invoke方法来处理有关路由的事务。

    先来看看RouteMiddleware的Invoke方法。

复制代码
复制代码 
        public async Task Invoke(HttpContext httpContext)
        {
            var context = new RouteContext(httpContext);//构造一个路由上下文，三个属性：HttpContext，Handler（一个委托），RouteData
            context.RouteData.Routers.Add(_router);

            await _router.RouteAsync(context);//这里的_router默认是MvcRouteHandler

            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);
            }
        }
复制代码
复制代码

    整个方法的逻辑就是：

  1. 构造一个路由上下文，此时context.Handler=null；
  2. 由MvcRouteHandler.RouteAsync()方法来处理请求（注意此时请求的路由信息在HttpContext中，而现在它又是RouteContext的一个属性）；
  3. 第二步的工作就是筛选最合适的Action，并把相应的委托赋给RouteContext.Handler；
  4. 如果RouteContext.Handler为null，说明匹配失败，路由工作到此结束，直接Invoke下一个Middleware；
  5. 如果到这一步，说明路由匹配成功，先把路由信息记录到HttpContext，然后调用RouteContext.Handler，触发有关Action的相关操作，那就是另一个主题了；
  6. RouteContext只在这个方法出现，到第五步时，上下文又变回了HttpContext，注意这个方法传入的时候就是HttpContext。就像帅哥HttpContext到了一个叫路由的地方，撩了一个叫RouteContext的妹子，等它离开时就把它抛弃了。

    接下来看一下MvcRouteHandler.RouteAsync()方法

复制代码
复制代码 
 1         public Task RouteAsync(RouteContext context)
 2         {
 3             //省略null检查
 4             var actionDescriptor = _actionSelector.Select(context);//关键！！找到最优的Action，并返回一个携带相关信息的数据类
 5             if (actionDescriptor == null)
 6             {
 7                 _logger.NoActionsMatched();
 8                 return TaskCache.CompletedTask;
 9             }
10             //省略action有默认值情况的处理
11             context.Handler = (c) => InvokeActionAsync(c, actionDescriptor);//关键！！将RouteContext的Handler属性置为相应的处理方法
12             return TaskCache.CompletedTask;
13         }
14 
15         private async Task InvokeActionAsync(HttpContext httpContext, ActionDescriptor actionDescriptor)
16         {
17             var routeData = httpContext.GetRouteData();//在RouteMiddleWare.Invoke()时候留下来的RouteData
18             try
19             {
20                 _diagnosticSource.BeforeAction(actionDescriptor, httpContext, routeData);
21 
22                 using (_logger.ActionScope(actionDescriptor))//日志记录
23                 {
24                     _logger.ExecutingAction(actionDescriptor);
25 
26                     var startTimestamp = _logger.IsEnabled(LogLevel.Information) ? Stopwatch.GetTimestamp() : 0;
27 
28                     var actionContext = new ActionContext(httpContext, routeData, actionDescriptor);//根据相应的数据构造ActionContext上下文
29 
30                     //省略部分非主要逻辑代码
31 
32                     var invoker = _actionInvokerFactory.CreateInvoker(actionContext);//构建一个有关Action处理的类型
33 
34                     await invoker.InvokeAsync();//触发Action处理
35 
36                     _logger.ExecutedAction(actionDescriptor, startTimestamp);
37                 }
38             }
39             finally
40             {
41                 _diagnosticSource.AfterAction(actionDescriptor, httpContext, routeData);
42             }
43         }
复制代码
复制代码

    注释已经解释的比较详细了。通过RouteContext选出最优的ActionDescriptor，我一笔带过了，不过这个过程与注册路由时候的解析一下，比较复杂。涉及到决策树之类的内容，感兴趣的同学可以深究。如果确实有Action匹配的话，RouteContext.Handler会被设置为相应的匿名方法。接着控制权交回给RouteMiddleware，然后触发InvokeActionAsync()方法，RouteContext的使命就此结束。

    从InvokeActionAsync()方法中可以看出，框架根据相应的ActionDescriptor生成相应的ActionContext，之后进行有关Controller和Action的动作。撩完RouteContext就该轮到ActionContextle。

总结

  1. 注册路由时，我们传入的路由模板(TemplateString)会在构造Route的时候被解析，参数名字、默认值以及约束都能在模板中被解析出来；
  2. MVC框架默认的路由Handler是MvcRouteHandler，它会在UseMvc()方法中自动添加；
  3. 注册路由的这些信息最终和其他服务一样，会变成Application委托链（中间件）的一部分；
  4. 解析请求路由时，路由的信息由HttpContext携带着；
  5. 假如MvcRouteHandler能解析请求的路由，就会触发有关Action的处理；否则路由过程结束，控制权交给下一个Middleware；也就是说，路由的RouterMiddleware会负责有关Action处理的部分。
  6. HttpContext是渣男，撩了一个又一个XXXContext。
@朱较瘦
关注
专栏目录
ASP.NET查找路由表RouteTable中路由名等信息的方法
HuLihui's Blog
08-18 5547
介绍了一个从ASP.NET路由表RouteTable中获取路由名、映射的虚拟路径、映射的物理路径等信息的方法，该方法在VS2012和.NET Framework 4.5下测试通过。
ASP.NET Core：路由
子昊
11-11 772
路由主要是由UseRouting和UseEndpoints两个组件协同完成的。我们可以将ASP.NET Core的应用设为一组终结点（能够通过http请求的方式访问的远程服务）的组合。 示例： public class demo14 { private static readonly Dictionary<string, string> Cities = new Dictionary<string, string> { ..
ASP.NET Core 源码阅读笔记(5) ---Microsoft.AspNetCore.Routing路由
weixin_34291004的博客
06-14 207
    这篇随笔讲讲路由功能，主要内容在项目Microsoft.AspNetCore.Routing中，可以在GitHub上找到，Routing项目地址。     路由功能是大家都很熟悉的功能，使用起来也十分简单，从使用的角度来说可讲的东西不多。不过阅读源码的过程的是个学习的过程，看看顶尖Coder怎么组织代码也是在提升自己。     我们知道现在ASP.NET Core中所有用到的功能都是服...
ASP.NET Core MVC 源码学习：Routing 路由
weixin_34269583的博客
03-20 94
前言 最近打算抽时间看一下 ASP.NET Core MVC 的源码，特此把自己学习到的内容记录下来，也算是做个笔记吧。 路由作为 MVC 的基本部分，所以在学习 MVC 的其他源码之前还是先学习一下路由系统，ASP.NET Core 的路由系统相对于以前的 Mvc 变化很大，它重新整合了 Web Api 和 MVC。 路由源码地址 ：https://github.com/aspnet/Routi...
ASP.NET Core 基础（九）——路由Routing
catshitone的专栏
04-20 1763
此文是在官方文档的基础上做的个人笔记，一些简单的内容就没用再列出来了，参考官方文档：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/routing?view=aspnetcore-5.0 定义：路由是负责匹配传入的http请求，然后进行发送到应用的可执行终结点（代码处理单元）。 本文只介绍较低级别的路由信息，有关MVC中的路由和Razor中的路由参考： https://docs.microsoft.com/zh-cn/aspnet/c.
ASP.NET Core中自定义路由约束的实现
10-17
为了提高路由的灵活性和可控性，*** Core支持自定义路由约束，这些约束可以限制URL中的某些部分必须匹配特定的模式。 在*** Core中实现自定义路由约束首先需要了解几个关键概念。首先是路由模板，它是定义路由规则...
详解ASP.NET Core MVC 源码学习：Routing 路由
10-20
3. **IRouter接口**：位于`Microsoft.AspNetCore.Routing.Abstractions`库中，是路由系统的核心接口。`IRouter`有两个主要方法：`RouteAsync`用于处理路由上下文，`GetVirtualPath`用于生成虚拟路径。 4. **...
ASP.NET Core MVC 源码学习：MVC 启动流程详解
dotNET跨平台
03-30 501
前言 在 上一篇 文章中，我们学习了 ASP.NET Core MVC 的路由模块，那么在本篇文章中，主要是对 ASP.NET Core MVC 启动流程的一个学习。 ASP.NET Core 是新一代的 ASP.NET 应用程序，它是跨平台的，并且不依赖于 IIS，新的 MVC Core 设计加入了依赖注入和模块化的 Http 处理管道，这篇文章我们一起通过源码看一下它的启动过程，每一步都很
ASP.NET Core MVC 源码探索：深入解析Routing路由机制
- **Microsoft.AspNetCore.Routing.Abstractions** 这个项目包含路由系统的抽象定义，如 `IRouter` 接口、`RouteContext` 类等。理解这些抽象可以帮助我们了解路由工作的基础。 - **Microsoft.AspNetCore.Routing*...
asp.net core mvc 中间件之路由
weixin_33834075的博客
09-04 289
asp.net core mvc 中间件之路由 路由中间件 首先看路由中间件的源码 先用httpContext实例化一个路由上下文，然后把中间件接收到的路由添加到路由上下文的路由集合 然后把路由上下文作为参数，调用IRouter.RouteAsync方法，该方法主要是进行路由匹配，匹配成功后给context.Handler赋值 如果路由匹配成功，且ha...
ASP.NET core webapi RouteAttribute _平台：windows (3)
二等碗
12-17 1893
ASP.NET core webapi RouteAttribute _平台：windows (3) 简版： 问题： 1、介绍RouteAttribute特性。 这个东西其实很简单：主要用处就是设置路由罢了 什么？不懂路由是什么？ 那么你就理解为这是个地址就好了。 如下图设置： api/values/get 访问后的结果： 啰嗦版如下： 我们创建一个webapi项目后，.netcore 会有...
asp.net core的Route和HttpMethod
最新发布
m0_46531302的博客
08-27 458
文章给出了一些多次使用特性的示例，展示了如何在控制器和动作方法上多次使用Route和HttpMethod特性来定义不同的路由模板和支持多个HTTP方法。 总的来说，这篇文章通过讲述一个bug和进行测试来介绍了在ASP.NET Core中配置约定路由时的一些注意事项和使用方法，帮助读者更好地理解和应用这些特性。
asp.net core 添加区域（Areas）遇到的问题
speak13579的专栏
07-18 2078
asp.net core 添加区域（Areas）后运行的时候报“InvalidOperationException: The constraint reference 'SPA' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions....
请求的服务“Microsoft.AspNetCore.Mvc.ViewFeatures”。尚未注册ITempDataDictionaryFactory。(学习笔记)
qq_41863998的博客
08-15 1396
开发过程中踩坑
.netcore入门16：aspnetcore之终结点路由工作原理
火焰
02-29 2363
环境： .netcore 3.1.1.0 vs2019 16.4.5 试验目的： 探索什么是终结点路由，它和授权中间件、mvc是怎么协作的？ 结论： 先说下结论，“路由”模块一前一后注册了两个中间件，第一个中间件匹配到了Controller的某个Action，第二个中间件去调用已经匹配到了的Action。“授权”模块会在这两个中间件之间注册一个中间件，所以授权模块在进行授权的时候可以明确当前的...
ASP.NETCORE MVC模块化
weixin_30877181的博客
05-19 494
ASP.NETCORE MVC模块化 原文:ASP.NETCORE MVC模块化ASP.NETCORE MVC模块化编程 前言 记得上一篇博客中跟大家分享的是基于ASP.NETMVC5，实际也就是基于NETFRAMEWORK平台实现的这么一个轻量级插件式框架。那么今天我主要分享的是自己工作中参考三方主流开源WEB框架OrchardCore、...
terminate called after throwing an instance of 'std::invalid_argument' what(): stod ./start_routing.sh: line 7: 9274 Aborted (core dumped) ${CURR_DIR}/../bin/routing_node 分析一下报错原因
07-14
这个错误是由于调用了 `std::stod` 函数时抛出了 `std::invalid_argument` 异常导致的。`std::stod` 是 C++ 标准库中的一个函数，用于将字符串转换为对应的双精度浮点数。然而，当字符串无法解析为有效的双精度浮点数时，就会抛出 `std::invalid_argument` 异常。 根据报错信息中的 `./start_routing.sh: line 7: 9274 Aborted (core dumped) ${CURR_DIR}/../bin/routing_node`，可以看出异常发生在 `start_routing.sh` 脚本的第7行，导致 `routing_node` 程序被终止并生成了核心转储文件。 要解决这个问题，需要检查第7行的代码，并确保在调用 `std::stod` 函数之前，传递给它的字符串是有效的双精度浮点数表示。可能的原因包括： 1. 传递给 `std::stod` 函数的字符串为空或不是有效的双精度浮点数表示。 2. 字符串中包含了无法解析为浮点数的字符，例如字母或特殊符号。 请检查相关代码，确保传递给 `std::stod` 函数的参数是有效的双精度浮点数表示。如果仍然有疑问或需要进一步帮助，请提供相关代码片段或更多上下文信息，以便我能够提供更具体的建议。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值