ASP.NET Core – 请求管道与中间件已关闭评论
215 次浏览

A+

所属分类：.NET技术

摘要

请求管道是什么？请求管道描述的是一个请求进到我们的后端应用，后端应用如何处理的过程，从接收到请求，之后请求怎么流转，经过哪些处理，最后怎么返回响应。请求管道就是一次请求在后端应用的生命周期。了解请求管道，有助于我们明白后端应用是怎么工作的，我们的代码是怎么工作的，在我们的业务代码执行前后经过哪些步骤，有助于我们之后更好的实现一些AOP操作。

便宜好用的国外VPS推荐

1. 请求管道

请求管道是 .net 应用的一个最基本的概念。在 .net core 中，微软对框架底层进行了全新的设计，相对于原本的ASP.NET中的全家桶模式的管道模型，.net core的管道模型更加灵活便捷,可做到热插拔，通过管道可以随意注册自己想要的服务或者第三方服务插件，这也是.net core性能更好的原因。

ASP.NET Core - 请求管道与中间件

以上是微软官方文档中的管道模型图。从图中可以看到服务器接收到请求之后，将接收到的请求向后传递，依次经过一个个 Middleware 进行处理，然后由最后一个 MiddleWare 生成响应内容并回传，再反向依次经过每一个 Middleware，直到由服务器发送出去。整个过程就像一条流水线一样，管道这个词是很形象的，而 Middleware 就像一层一层的“滤网”，过滤所有的请求和响应。

2. 中间件

管道之中，对请求、响应进行加工处理的模块是 Middleware，也就是中间件。中间件本质上是一个委托。

2.1 工作模式

从上面的图可以看出，每一个中间件都会被执行两次，在下一个中间件执行之前和之后各执行一次，分别是在处理请求和处理响应，只有一个中间件是例外的，那就是最后一个中间件，它后面没有下一个中间件，所以执行到它管道就会回转。

这代表了中间件的两种工作模式，也是中间件的两种基本注册方式。中间件本质上是一个委托，在代码实现上就体现在委托的入参有所不同以及注册调用的方法不同。

中间件两种最基本的注册方式：

Use 方法注册
- use 注册的中间件会传入next参数，在处理完本身的逻辑之后可以调用 next() 去执行下一个中间件
- 如果不执行，就等于Run
Run 方法注册
- Run 只是执行，没有去调用Next ，一般作为终结点。
- Run 方法注册，只是一个扩展方法，最终还是调用Use方法

在代码中分别是以下方式：

app.Use(async (context, next) => {     await context.Response.WriteAsync("Hello Middlerware !");     if(context.Request.Query.TryGetValue("query", out var query))     {         await context.Response.WriteAsync(query);     }     await next();     await context.Response.WriteAsync("End Middleware !"); });  app.Run(async context => {     await context.Response.WriteAsync("Hello last Middleware"); });

最后的执行结果如下，也可以从代码执行的先后顺序看出管道流动的顺序。当前中间件手动调用 next() 之后，就进入下一个中间件，下一个中间件处理完成之后，按照管道的顺序再一个一个回传。在这个过程中一直不变，被管道传递的就是HttpContext，而我们拿到 HttpContext，即可以通过 Request 和 Response 对当前这一次的请求做任何处理了。

ASP.NET Core - 请求管道与中间件

通过分析asp.net core的源码，可以看到在我们调用 Run() 的时候，实际上还是调用了 Use() 方法。

ASP.NET Core - 请求管道与中间件

而 Use() 方法中，主要的逻辑仅仅只是将相应的委托存放到集合中

ASP.NET Core - 请求管道与中间件

之后在 build 方法调用的时候才一个一个地调用中间件委托。

ASP.NET Core - 请求管道与中间件

除了上面的 Use() 、Run() 两个最基本的方法注册中间件之外，还有另外一些方法，如通过 Map() 方法注册中间件，这种方式会创建一个新的管道分支，在路由满足Map的规则时，请求则转型新的管道分支，最后沿着管道分支返回响应，而不走原有的管道。

app.Use(async (context, next) => {     await context.Response.WriteAsync("Hello Middlerware1 ! ");     if(context.Request.Query.TryGetValue("query", out var query))     {         await context.Response.WriteAsync(query);     }     await next();     await context.Response.WriteAsync("End Middleware1 ! "); });  app.Map("/map", app => {     // map方法中的委托，传入的时IApplicationBuilder, 在这里相当于一个新的管道，也可以和主管道一样进行任意操作     app.Run(async context =>     {         await context.Response.WriteAsync("Hello map Middleware pipeline ! ");     }); });  app.Run(async context => {     await context.Response.WriteAsync("Hello last Middleware ! "); });

执行结果如下：

ASP.NET Core - 请求管道与中间件

其他的分支管道创建方式，如 MapWhen，和 Map 大同小异，只是对于匹配判断的方式有所不同。像微软内置中间件中的静态文件中间件，MVC 中间件，其实都是以分支管道的方式实现的，一旦匹配到请求就会走管道分支。

2.2 中间件的使用配置

使用一个中间件需要在 .net core 的入口文件中进行配置，如果是 .net 6版本，那只要在 program.cs 文件中进行配置即可，通过 WebApplication 对象，也就是 app 调用相关的方法。

ASP.NET Core - 请求管道与中间件

如果是 .net 6 以下版本，可以在 startup.cs 文件中的 Configure 方法中配置。.net 6 与之前版本入口文件的不同上一篇文章也讲过，这里就不赘述了。

ASP.NET Core - 请求管道与中间件

这里可以看得到，一些中间件的调用并没有直接使用 Use() 和 Run()，毕竟将各个中间件的处理逻辑全部放在入口文件很不好管理，而且也很不优雅。这里涉及到了中间件封装的约定规则，一般情况下封装一个中间件都会提供一个 Use[Middleware] 方法以供使用者进行中间件的调用，WebApplication 对象的 UseXXX 方法都是中间件调用的方法。