dotnetCore增加MiddleWare的Run,Use Map MapThen四个扩展方法

什么是中间件

中间件是在管道中处理Request请求与Responses响应的一种组件，每种组件可以选择是否让Request进入到下一个组件去处理。

译得不好，大家可以自己看原文Middleware

更详细的还可以参照园中大神的作品；

有汤姆大叔的解读ASP.NET 5 & MVC6系列（6）：Middleware详解 

artech大神的 ASP.NET Core真实管道详解[1]：中间件是个什么东西？

怎么创建一个Middleware请参考英文文档Middleware 或者

LineZero的 ASP.NET Core 开发-中间件(Middleware)

要正确使用Middleware来构建自己的应该程序，需要理解Run,Use,Map,MapThen这四个方法是如何使用的， 下面Ricman将自己的理解与大家分享。

一、Run扩展方法

Run方法在说明上是这样的:在管道的尾端增加一个Middleware；它是执行的最后一个Middleware。即它执行完就不再执行下一个Middleware了。如下代码示例。

 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();
            var loger = loggerFactory.CreateLogger("TestLogger");
          
            //第一个Run 执行了
            app.Run(async context =>
            {
                loger.LogInformation("run 1 start");
                await context.Response.WriteAsync("hello world!,run 1");
                loger.LogInformation("run 1 end");
            });

            //第二个Run 没的执行
            app.Run(async context =>
            {
                loger.LogInformation("run 2 start");
                await context.Response.WriteAsync("hello world!,run 2");
                loger.LogInformation("run 2 end");
            });
            
        }

 

输出的结果为：

只打印出了第一个Run中的内容。而程序也不会响应第二个Run方法中的内容。

 

二、Use扩展方法

Use方法，则是在管道中增加一个Middleware。如果调用了next.Invoke()方法，它会去执行下一个Middleware 。我们把上面的例子稍作修改：

 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();
            var loger = loggerFactory.CreateLogger("TestLogger");
          
            //use 方法 执行了
            app.Use (async (context,next) =>
            {
                loger.LogInformation("Use 1 start");
                await context.Response.WriteAsync("hello world!,Use 1");
                loger.LogInformation("Use 1 end");
            });

            //Run 方法没的执行
            app.Run(async context =>
            {
                loger.LogInformation("run 1 start");
                await context.Response.WriteAsync("hello world!,run 1");
                loger.LogInformation("run 1 end");
            });
            
        }

 

输出结果是什么？

没有调用next.Invoke();尾端的Middleware即Run方法内没有执行。使用Use方法，而没有调用next.Invoke()，Use的效果与Run的效果是一致的。为了验证Use 的效果，我们再修改代码。

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();
            var loger = loggerFactory.CreateLogger("TestLogger");
          
            //执行了
            app.Use (async (context,next) =>
            {
                loger.LogInformation("Use 1 start");
                await context.Response.WriteAsync("hello world!,Use ");
                await next.Invoke();
                loger.LogInformation("Use 1 end");
            });

            //没的执行
            app.Run(async context =>
            {
                loger.LogInformation("run 1 start");
                await context.Response.WriteAsync("  hello world!,run ");
                loger.LogInformation("run 1 end");
            });
            
        }

 

此时，输入以下的结果

即Use与Run代码段都被执行了。需要注意的是，管道中可以增加多个middleware，他们是按顺序执行的，执行的顺序与在Configure方法中代码的顺序是一致的。

 

三、Map与MapThen

Map比较不同，它将Middleware添加到管道中，它是在管道中增加了分枝。通过影射路径的方式，增加管道分枝。我们保留上面例子，并增加代码。如下：

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();
            var loger = loggerFactory.CreateLogger("TestLogger");
          
            //执行了
            app.Use (async (context,next) =>
            {
                loger.LogInformation("Use 1 start");
                await context.Response.WriteAsync("hello world!,Use ");
                await next.Invoke();
                loger.LogInformation("Use 1 end");
            });

            app.Map("/mapTest", HandleMap);

            //没的执行
            app.Run(async context =>
            {
                loger.LogInformation("run 1 start");
                await context.Response.WriteAsync("  hello world!,run ");
                loger.LogInformation("run 1 end");
            });
            
        }

        private static void HandleMap(IApplicationBuilder app)
        {
            app.Run(async context =>
            {
                await context.Response.WriteAsync("Hello ,that is Handle Map ");
            });
        }

 

运行起来，我们在浏览器中输入” http://localhost:12716/mapTest” 得到的结果如下：

mapTest分枝被执行了。

MapThen就更有意思，从字面上感觉有点类似查询的意思。对了。它就是处理符合条件的Request去执行给定的方法。我们修改代码

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();
            var loger = loggerFactory.CreateLogger("TestLogger");
          
            //执行了
            app.Use (async (context,next) =>
            {
                loger.LogInformation("Use 1 start");
                await context.Response.WriteAsync("hello world!,Use ");
                await next.Invoke();
                loger.LogInformation("Use 1 end");
            });

            app.MapWhen(context =>
           { 
             return context.Request.Query.ContainsKey("q"); 
           }, HandleQuery);
            //没的执行
            app.Run(async context =>
            {
                loger.LogInformation("run 1 start");
                await context.Response.WriteAsync("  hello world!,run ");
                loger.LogInformation("run 1 end");
            });
            
        } 
        private static void HandleQuery(IApplicationBuilder app)
        {
            app.Run(async context =>
            {
                   await context.Response.WriteAsync("  Hello ,this is Handle Query ");
            });
        }

 

我们要处理的是:如果有URL中的参数包含了q字母的话，就去执行HandleQuery方法。看一下结果

 

可以看出来，MapWhen可以处理很多的东西，比如我们要处理Request表头中某特定的内容，可以使用MapWhen来处理。

 

如果你觉得本文对你有帮助，请点击“推荐”