ASP.NET Core中间件的概念及基本使用

什么是中间件

中间件是ASP.NET Core的核心组件，MVC框架、响应缓存、身份验证、CORS、Swagger等都是内置中间件。

1. 广义上来讲：Tomcat、WebLogic、Redis、IIS；狭义上来讲，ASP.NET Core中的中间件指ASP.NET Core中的一个组件。
2. 中间件由前逻辑、next、后逻辑3部分组成，前逻辑为第一段要执行的逻辑代码、next为指向下一个中间件的调用、后逻辑为从下一个中间件执行返回所执行的逻辑代码。每个HTTP请求都要经历一系列中间件的处理，每个中间件对于请求进行特定的处理后，再转到下一个中间件，最终的业务逻辑代码执行完成后，响应的内容也会按照处理的相反顺序进行处理，然后形成HTTP响应报文返回给客户端。
3. 中间件组成一个管道，整个ASP.NET Core的执行过程就是HTTP请求和响应按照中间件组装的顺序在中间件之间流转的过程。开发人员可以对组成管道的中间件按照需要进行自由组合。

中间件的三个概念

Map、Use和Run。Map用来定义一个管道可以处理哪些请求，Use和Run用来定义管道，一个管道由若干个Use和一个Run组成，每个Use引入一个中间件，而Run是用来执行最终的核心应用逻辑。

中间件的基本使用

此为案例，不推荐这样使用

app.Map("/test", async (appBuilder) =>
{appBuilder.Use(async (context, next) =>{context.Response.ContentType = "test/html";await context.Response.WriteAsync("1 Start<br/>");await next();await context.Response.WriteAsync("1 End<br/>");});appBuilder.Use(async (context, next) =>{await context.Response.WriteAsync("2 Start<br/>");await next();await context.Response.WriteAsync("2 End<br/>");});appBuilder.Run(async context =>{await context.Response.WriteAsync("Run<br/>");});
});

中间件类

简单的自定义中间件

1. 如果中间件的代码比较复杂，或者我们需要重复使用一个中间件的话，我们最好把中间件的代码放到一个单独的“中间件类”中。
2. 中间件类是一个普通的.NET类，它不需要继承任何父类或者实现任何接口，但是这个类需要有一个构造方法，构造方法至少要有一个RequestDelegate类型的参数，这个参数用来指向下一个中间件。这个类还需要定义一个名字为Invoke或InvokeAsync的方法，方法至少有一个HttpContext类型的参数，方法的返回值必须是Task类型。中间件类的构造方法和Invoke（或InvokeAsync）方法还可以定义其他参数，其他参数的值会通过依赖注入自动赋值。

需求

检查请求中是否有password=123的查询字符串，而且会把请求报文体按照Json格式尝试解析为dynamic类型的对象，并且把dynamic对象放入context.Items中供后续的中间件或者Run使用。

实现

Nuget：Install-Package Dynamic.Json

public class CheckMiddleware
{private readonly RequestDelegate _next;public CheckMiddleware(RequestDelegate next){_next = next;}public async Task InvokeAsync(HttpContext context){//从请求的查询字符串中获取名为password的参数值string password = context.Request.Query["password"];if (password == "123"){//检查请求的内容类型是否为JSONif (context.Request.HasJsonContentType()){//获取请求体的流Stream stream = context.Request.BodyReader.AsStream();//将流中的JSON数据解析为动态对象，并将解析后的对象存入Items集合dynamic obj = await DJson.ParseAsync(stream);context.Items["BodyJson"] =obj;}await _next(context);}else{context.Response.StatusCode = 403;}}
}Program.cs
app.Map("/test", async (appBuilder) =>
{appBuilder.UseMiddleware<CheckMiddleware>();appBuilder.Run(async context =>{dynamic? obj = context.Items["BodyJson"];if (obj != null){await context.Response.WriteAsync($"{obj}");}});
});