asp.net core 3.x Endpoint终结点路由1-基本介绍和使用

前言

我是从.net 4.5直接跳到.net core 3.x的,感觉asp.net这套东西最初是从4.5中的owin形成的。
目前官方文档重点是讲路由,没有特别说明与传统路由的区别,本篇主要介绍终结点路由的相关概念和如何使用,不会详细介绍路由,这个参考官方文档就ok了。如果将来有机会研究到底层再深度剖析。

参考:
https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/routing?view=aspnetcore-3.1
https://q.cnblogs.com/q/113644/ 
https://aregcode.com/blog/2019/dotnetcore-understanding-aspnet-endpoint-routing/

概述

最初我们访问 http://www.abc.com/a.aspx时,服务端是存在a.aspx这个文件的,服务端根据此文件帮我们创建一个对应类的实例处理请求。
后来需求越来越复杂,出现了路由,目的是将请求地址与执行请求的处理器的直接关联,变成映射关联,映射规则由我们自己配置。
在asp.net core 3.x之前这个路由系统是包含在mvc内部的,.net framework时代有个特殊的HttpModule来实现mvc,路由系统也包含其中。.net core是由有个特殊的中间件来实现mvc的,路由系统就包含在这个中间件中。
这种方式有个问题,mvc只是一个中间件,路由系统包含在其中,如果我们希望在mvc中间件之后加入其它中间件,其它中间件是无法(也许是不方便)访问路由相关信息的。
另外asp.net core并不是只有mvc,还有webapi、blazor、signlR、接入gRpc等,将来还有更多,我们的路由系统能否提出来,让所有框架都可以用?

因此出现了终结点路由,我们说路由的根本目的是将用户请求地址,映射为一个请求处理器,最简单的请求处理器可以是一个委托 Func<HttpCotnext,Task>,也可以是mvc/webapi中某个controller的某个action,所以从抽象的角度讲 一个终结点 就是一个处理请求的委托。由于mvc中action上还有很多attribute,因此我们的终结点还应该提供一个集合,用来存储与此请求处理委托的关联数据。
从抽象的角度可以简单理解为   一个终结点 = 处理请求的委托 + 与之关联的附加(元)数据。对应到mvc来理解的话 终结点 = action + 应用其上的attribute集合。但记住终结点是个抽象的概念,并不只服务于mvc,原理大概如下:

  1. 在程序启动前我们应该定义好程序中有哪些终结点,当然不是我们手动一个个定义,而是根据目标框架自动生成,针对mvc来说的话可以自动将程序中与路由匹配的action转换成对应的终结点,其它框架应该也有对应的方式,反正最终我们所有用来处理请求的东东都变成了终结点。这步是在定义路由时自动完成的
  2. 除了定义终结点我们还要定义 请求路径 与 终结点的对应关系,将来请求抵达时才能匹配找到合适的终结点来处理我们的请求,这步相当于定义路由
  3. 我们还需要定义一个解析器,当请求抵达时根据终结点与路径的对应关系找到终结点,微软已定义好对应的中间件来表示这个解析器。
  4. 最后我们需要定义一个中间件,在上面的中间件执行后 我们可以拿到与当前请求匹配的终结点,最终调用它的委托处理请求,这个中间件就是mvc中间件
  5. 到此asp.net core 3.x的中间件路由默认差不多就这样了,此时我们可以定义自己的中间件,放在步骤3后面,拿到终结点做一些高级处理。微软定义的一些中间件也是这个套路

如何使用

在通过vs默认模板创建asp.net core 3.x项目时,在startup中会看到这样的代码

1 app.UseRouting();
2 app.UseEndpoints(endpoints => {
3   endpoints.MapControllerRoute(
4     name: "default",
5     pattern: "{controller=Home}/{action=Index}/{id?}");
6 });

注册路由

看代码的第2行。它有如下3个任务

  1. 创建终结点定义,针对mvc来说会自动将程序中与路由格式匹配上的action转换为终结点。在第5行之后可以调试观察endpoints.DataSource属性,生成好的终结点就在里面
  2. 建立url与终结点的对应关系,这种关系存在哪?我也不晓得
  3. 注册mvc中间件(它在将来请求抵达,且之前有中间件解析得到与当前请求匹配的终结点后,开始mvc旅程)

这里路由跟以前的写法差不多,上面默认值啊、约束啊就去看官方文档吧。
创建终结点也会参照属性路由,微软推荐webapi使用属性路由,mvc使用传统路由。你会看到创建默认webapi项目时这样的 endpoints.MapControllers();

终结点进一步定制

默认情况下是根据定义的路由去找到匹配的action最后生成终结点,这个生成终结点的过程我们是可以参与的,具体办法是通过endpoints.MapControllerRoute的返回对象上调用相关扩展方法,本质上是向终结点的创建过程加入一些委托,将来创建终结点时,这些委托将被调用,代码如下:

1 endpoints.MapControllerRoute(
2                     name: "default",
3                     pattern: "{controller=Home}/{action=Index}/{id?}").Add(endpointBuilder=> {
4                         //通过endpointBuilder获取与action关联的数据,比如attribute和其它元数据
5                         //通过endpointBuilder插入我们向放进终结点的数据
6                     });

动态路由

app.UseEndpointsmvc时就说明了使用mvc和webapi了,默认情况下一个action会创建一个对应的终结点,请求抵达时匹配到终结点就直接执行了。但有时候我们希望自己控制一个请求过来时使用哪个controller的哪个action,具体做法:
定义一个类,继承DynamicRouteValueTransformer,并注册到ioc容器中,最后调用一个扩展方法,看代码:

 1     class MyRouteValueTransformer : DynamicRouteValueTransformer
 2     {
 3         public override ValueTask<RouteValueDictionary> TransformAsync(HttpContext httpContext, RouteValueDictionary values)
 4         {
 5             //通过values可以拿到原始路由数据
 6             //可以替换或加入新的数据
 7             values.Add("controller", "jj");
 8             values.Add("action", "kkk");
 9             return new ValueTask<RouteValueDictionary>(values);
10         }
11     }
12
13 public void ConfigureServices(IServiceCollection services)
14         {
15             services.AddSingleton<MyRouteValueTransformer>();
16             services.AddControllers();
17         }
18
19 endpoints.MapDynamicControllerRoute<MyRouteValueTransformer>("aaa/bbb/{id}");

这样将来请求抵达时,解析得到终结点时会调用我们的MyRouteValueTransformer,我们可以获取已解析得到的路有数据,然后选择替换/增加某些路由数据,从而达到定制化

回退路由

默认情况下请求抵达时,若没有找到匹配的终结点,就直接404了,我们希望当没有匹配到任何终结点时直接执行某个默认的终结点,可以用如下方式:

endpoints.MapFallbackToController("{controller}/{action}/{id?}", "kkk", "jj");

当请求抵达时,如果没有匹配到任何终结点,则默认执行jjController.kkk方法。可以想象得到此功能可能是通过动态路由实现的

还有几个相关的扩展方法,有了上面的讲解,估计你也能猜出是干嘛用的了。关于路由注册就暂时说这么多

自定义中间件提前拿到终结点数据

app.UseRouting();对应概述中的步骤3,此扩展方法内部会注册一个中间件,将来请求抵达时它会帮我们找到与当前请求匹配的终结点并存储在HttpContext中,且匹配过程中解析得到的路由数据在Request.RouteValues中。我们可以在它后面加入自己的中间件

1 app.UseRouting();
2 app.Use((conttext,next)=> {
3       var endpoint = conttext.GetEndpoint();//拿到终结点
4       var routeData = conttext.Request.RouteValues;//拿到路由数据     //做些牛B的事
5       return next();
6 });

原文地址:https://www.cnblogs.com/jionsoft/p/12115417.html

时间: 2024-07-31 09:53:13

asp.net core 3.x Endpoint终结点路由1-基本介绍和使用的相关文章

Asp.Net Core EndPoint 终结点路由工作原理解读

一.背景 在本打算写一篇关于Identityserver4 的文章时候,却发现自己对EndPoint -终结点路由还不是很了解,故暂时先放弃了IdentityServer4 的研究和编写:所以才产生了今天这篇关于EndPoint (终结点路由) 的文章. 还是跟往常一样,打开电脑使用强大的Google 和百度搜索引擎查阅相关资料,以及打开Asp.net core 3.1 的源代码进行拜读,同时终于在我的实践及测试中对EndPoint 有了不一样的认识,说到这里更加敬佩微软对Asp.net cor

ASP.NET Core中使用默认MVC路由

ASP.NET Core里Route这块的改动不大,只是一些用法上有了调整,提供了一些更加简洁的语法. 而对于自定义路由的支持当然也是没有问题的,这个功能应该是从MVC1.0版本就已经有这个功能. 先看看ASP.NET Core里面实现默认MVC路由的配置方式 通常情况下,在使用MVC项目的时候,默认的路由就足够了,就是常见的通过Controller和Action获取具体的方法的方式. 从一个最基本的项目开始,执行以下步骤,就可以使得项目支持MVC路由 1.创建一个空白的ASP.NET Core

Asp.Net Core下的两种路由配置方式

与Asp.Net Mvc创建区域的时候会自动为你创建区域路由方式不同的是,Asp.Net Core下需要自己手动做一些配置,但更灵活了. 我们先创建一个区域,如下图 然后我们启动访问/Manage/Home/Index 发现是404没有找到该页面,因为我们还没有为其配置路由,下面使用两种配置区域路由的方式 1.通过配置MapRoute app.UseMvc(routes => { routes.MapRoute( name: "default", template: "

asp.net core 系列 7 Razor框架路由(上)

一.概述 在上二篇中,主要是介绍了asp.net core mvc中路由的使用,这篇继续介绍路由在ASP.NET Core Razor中的使用.Razor Pages应该使用默认的传统路由,从应用程序的Pages文件夹中提供命令资源.还可以使用其他约定来自定义 Razor Pages 路由行为. 在ASP.NET Core MVC 中是使用路由中间件来匹配传入请求的 URL 并将它们映射到操作(action).而ASP.NET Core  Razor使用页面路由和应用模型提供程序约定,来控制 R

asp.net core 系列 8 Razor框架路由(下)

三.页面路由操作约定 接着上篇讲asp.net core 系列 7 Razor框架路由.在上篇继续第三节 "页面路由操作约定" 的最后一小节 AddPageRoute . 3.3. 配置页面路由AddPageRoute 使用 AddPageRoute 配置路由,该路由与指定页面关联, 使用指定的路由生成页面链接. AddPageRoute 使用 AddPageRouteModelConvention 建立路由. 示例应用为 Privacy.cshtml 创建指向 /ThePrivacy

ASP.NET Core MVC/WebAPi如何构建路由?

前言 本节我们来讲讲ASP.NET Core中的路由,在讲路由之前我们首先回顾下之前所讲在ASP.NET Core中的模型绑定这其中有一个问题是我在项目当中遇见的,我们下面首先来看看这个问题. 回顾ASP.NET Core模型绑定 我们有这样一个场景:修改个人资料中的各个属性,此时每个属性的值的类型肯定是不一样的,所以我们将值定义为object,如下model. public class BlogViewModel { public string prop { get; set; } publi

asp.net core 系列 5 MVC框架路由(上)

一. 概述 介绍asp.net core路由时,我初步想了下,分几篇来说明.  路由的知识点很多,参考了官方文档提取出一些重要的知识点来说.    在ASP.NET Core中是使用路由中间件来匹配传入请求的 URL 并将它们映射到操作(action方法).路由是在程序启动时进行传统路由或属性路由定义. 路由描述如何将 URL 路径与操作相匹配. 它还用于在响应中生成送出的 URL(用于链接). 路由操作既支持传统路由,也支持属性路由.也可混合使用.通常传统路由用于为浏览器处理 HTML 页面的

asp.net core 系列 6 MVC框架路由(下)

一.URL 生成 接着上篇讲MVC的路由,MVC 应用程序可以使用路由的 URL 生成功能,生成指向操作的 URL 链接. 生成 URL 可消除硬编码 URL,使代码更稳定.更易维护. 此部分重点介绍 MVC 提供的 URL 生成功能,并且仅涵盖 URL 生成工作原理的基础知识. IUrlHelper 接口用于生成 URL,是 MVC 与路由之间的基础结构的基础部分. 在控制器.视图和视图组件中,可通过 Url 属性找到 IUrlHelper 的实例. // // mvc 框架的Controll

Asp.Net Core 入门(六)—— 路由

Asp.Net Core MVC的路由在Startup.cs文件中的Configure方法中进行配置,使其加入到Http请求管道中,如果不配置,那么我们所发送的请求无法得到象应. 那么该怎么配置Asp.Net Core MVC的路由呢?通常是在Configure方法最后一行加入 app.UseMvcWithDefaultRoute(); 或者 app.UseMvc(); app.UseMvcWithDefaultRoute(); //使用默认路由 app.UseMvc(routes => { r