ASP.NET Core 中间件(一)

作为一个合格的搬砖程序员，小妹打开了VS2019搭建了人生中的第一个.NetCore项目，根据IDE工具的提示搭建好项目后，在初始项目中我们会发现有这么几个文件

内部文件简介：
Properties&launchSettings.json 是一个启动配置文件，其用于应用的启动准备工作，包括环境变量，开发端口等。

Program类是项目的启动项，会为我们创建并初始化Web应用，并通过Startup类中的ConfigureServices和Configure方法，完成依赖注入和中间件管道的搭建。

Startup类

看到这，小妹有点懵了，啥是中间件？怎么配置中间件？额…带着问题找答案。百度了一下：

啥是中间件（Middleware）？
1.中间件是组装到应用程序管道中以处理请求和响应的软件。
2.每个组件选择是否将请求传递给管道中的下一个组件。
3.每个组件可以在调用管道中的下一个组件之前和之后执行工作。
4.请求委托（Request delegates）用于构建请求管道，处理每个HTTP请求。

怎么配置中间件？
请求委托使用Run，Map和Use扩展方法进行配置。单独的请求委托可以以内联匿名方法（称为内联中间件）指定，或者可以在可重用的类中定义它。这些可重用的类和内联匿名方法是中间件或中间件组件。请求流程中的每个中间件组件都负责调用流水线中的下一个组件，如果适当，则负责链接短路。
将HTTP模块迁移到中间件解释了ASP.NET Core和以前版本（ASP.NET）中的请求管道之间的区别，并提供了更多的中间件示例。

使用 IApplicationBuilder 创建中间件管道
ASP.NET Core请求流程由一系列请求委托组成，如下图所示（执行流程遵循黑色箭头）：

每个委托可以在下一个委托之前和之后执行操作。委托还可以决定不将请求传递给下一个委托，这称为请求管道的短路。短路通常是可取的，因为它避免了不必要的工作。例如，静态文件中间件可以返回一个静态文件的请求，并使管道的其余部分短路。需要在管道早期调用异常处理委托，因此它们可以捕获后面管道的异常。
最简单的可能是ASP.NET Core应用程序建立一个请求的委托，处理所有的请求。此案例不包含实际的请求管道。相反，针对每个HTTP请求都调用一个匿名方法。

直接上代码吧！

上面文章说道中间件是应用程序管道中以处理请求和响应的软件，主要用委托实现，请求委托使用Run，Map和Use扩展方法进行配置
一、app.Run

   public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {

            app.Run(async context =>
            {
                await context.Response.WriteAsync("I'm Run1\r\n");
            });
            app.Run(async context =>
            {
                await context.Response.WriteAsync("I'm Run2\r\n");
            });
        }

 rgb(153, 153, 153);">5
6
7
8
9
10
11
12
13

运行结果：执行了两个委托

总结：使用Use方法，而没有调用next.Invoke()，Use的效果与Run的效果是一致的。调用next.Invoke()后Use与Run代码段都被执行了。需要注意的是，管道中可以增加多个middleware（中间件），他们是按顺序执行的，执行的顺序与在Configure方法中代码的顺序是一致的。
三、Map和MapWhen
Map比较不同，它将Middleware(中间件)添加到管道中，它是在管道中增加了分支。通过影射路径的方式，增加管道分支。我们保留上面例子，并增加代码。如下：

 public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            
            app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("I'm Use1\r\n");
                await next.Invoke();
            });

            app.Map("/maptest", MapTest);//映射路径访问指定的Middleware

            app.Run(async context =>
            {
                await context.Response.WriteAsync("I'm Run2\r\n");
            });
        }

        private static void MapTest(IApplicationBuilder app) {
            app.Use(async (context,next)=> {
                await context.Response.WriteAsync("this is maptest \r\n");
                await next.Invoke();
            });
        }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

启动iis，在地址后面增加映射的地址如：https://localhost:44301/maptest，运行结果：

maptest分支被执行了

MapWhen:顾名思义满足条件的情况下执行相应的方法

 public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            
            app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("I'm Use1\r\n");
                await next.Invoke();
            });

            //app.Map("/maptest", MapTest);//映射路径访问指定的Middleware
            //如果有URL中的参数包含了zz，满足这个条件，就执行MapTest
            app.MapWhen(context=> { return context.Request.Query.ContainsKey("zz"); }, MapTest);
            app.Run(async context =>
            {
                await context.Response.WriteAsync("I'm Run2\r\n");
            });
        }

        private static void MapTest(IApplicationBuilder app) {
            app.Use(async (context,next)=> {
                await context.Response.WriteAsync("this is maptest \r\n");
                await next.Invoke();
            });
        }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

如果有URL中的参数包含了zz，满足这个条件，就执行MapTest，地址：https://localhost:44301/?zz=1，运行结果：

通过以上的操作，小妹好像已经了解了什么是管道，什么是中间件，ASP.NET Core提供了附带中间件组件，如下：

好了，有啥总结的不好的，请各位大神多多指教。回家！
.Net技术交流群：274407988，欢迎大家进群交流学习。