中间件 Middleware

# 1、概念
中间件是一种处理HTTP请求和响应的独立组件，它位于客户端请求与服务器端处理程序之间。每个中间件组件负责执行特定任务，并可以选择将请求传递给管道中的下一个中间件，直至请求被最终处理或响应被返回给客户端。

常用内置中间件：

| 中间件名称    | 英文名称                | 作用                  |
|----------|---------------------|---------------------|
| 身份验证中间件  | UseAuthentication   | 提供身份验证支持            |
| 异常处理中间件  | UseExceptionHandler | 异常/错误处理             |
| 跨域中间件    | UseCors             | 配置跨域资源共享            |
| 路由中间件    | UseRouting          | 定义和约束请求路由           |
| 静态文件中间件  | UseStaticFiles      | 为静态文件和目录浏览提供服务提供支持  |
| 授权中间件    | UseAuthorization    | 用于授权用户访问安全资源        |
| 终结点路由中间件 | UseEndpoints        | 定义和约束请求路由，用于匹配路由的终端 |

执行流程：
![](/media/202408/2024-08-15_145937_9719460.8978649338564981.png)

中间件顺序：
![](/media/202408/2024-08-15_150117_7584890.9765762351751318.png)

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

```java
//## 使用use添加单个中间件##
app.Use(async (context, next) =>
{
    context.Request.Headers.Add("head1", "11");
    await next.Invoke();
    Console.WriteLine(context.Request.Headers["head1"]);
    Console.WriteLine("22");
});

//## 使用map为指定路由的action添加中间件，以下就是一个管道##
app.Map("/api/FilterAttribute/test1", appbuilders =>
{
    //第一个中间件
    appbuilders.Use(async (context, next) =>
    {
        context.Request.Headers.Add("head3", "33");
        await next.Invoke();
        Console.WriteLine(context.Request.Headers["head3"]);
        Console.WriteLine("44");
    });
    //第二个中间件
    appbuilders.Use(async (context, next) =>
    {
        context.Request.Headers.Add("head5", "55");
        await next.Invoke();
        Console.WriteLine(context.Request.Headers["head5"]);
        Console.WriteLine("66");
    });
 
    //第三个中间件，也是终止
    appbuilders.Run(async context =>
    {
        Console.WriteLine("/FilterAttribute这个路径下的中间件结束了");
    });
});

//##使用MapWhen判断是否执行中间件##
app.MapWhen(context =>
{
    return 1 == 1;//如果返回true，则执行下面的中间件
}, appbuilder =>
{
    appbuilder.Use(async (context, next) =>
    {
        Console.WriteLine("77");
        await next.Invoke();
        Console.WriteLine("88");
    });
    appbuilder.Run(async context =>
    {
        Console.WriteLine("77");
    });
});

```

自定义中间件

```java
public class MyMiddleware1
    {
        //需要有RequestDelegate、InvokeAsync方法参数是HttpContext类型
        private readonly RequestDelegate _requestDelegate;
        public MyMiddleware1(RequestDelegate requestDelegate)
        {
            _requestDelegate = requestDelegate;
        }
 
        public async Task InvokeAsync(HttpContext context)
        {
            Console.WriteLine("MyMiddleware1执行前");
            await _requestDelegate.Invoke(context);
            Console.WriteLine("MyMiddleware1执行后");
        }
 
    }
 
//在program.cs中
app.UseMiddleware<MyMiddleware1>();
```