关于.net:如何在-ASPNet-Core-中使用-条件中间件

ASP.Net Core 是微软开源的跨平台、可扩大、轻量级的模块化框架，可用于构建高性能的 web 应用程序。中间件组件能够注入到 ASP.Net Core 申请管道中实现对 Request 和 Response 的定制和批改。

ASP.Net Core 中间件能够用于查看、路由或者批改流转于 Pipeline 的 Request 和 Response。本文将会探讨如何应用这些中间件来实现一些高级操作。

Use、Map，Run 办法罕用来一起构建 HTTP Pipeline 管道，上面疾速浏览一下这些办法和它们的用处。

该办法将会执行一个委托，而后将 交接棒 传给 Pipeline 的下一个中间件，因该办法短暂领有 交接棒 ，所以该办法可用于 短路操作。

该办法会执行委托并返回后果。

该办法将有条件地执行委托并返回后果。

中间件是在 Startup.Configure 中进行注册，调用办法就是 Use* 系列扩大办法，上面是注册中间件的语法。


public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{app.UseMyCustomMiddleware<MyCustomMiddleware>();
}

须要留神的是，中间件的执行程序和你注册的程序是保持一致的。

每个中间件都蕴含一个 Invoke() 办法, 这个办法参数是 HttpContext 的一个实例，本中间件的业务逻辑会在下一个中间件的执行前后都会被执行，如果你有点懵的话，能够理解一下什么叫：递归调用，如上面代码正文所示：


public async Task Invoke(HttpContext context)
{
    // Write code here that will be executed before the
    // next middleware is called
        await _next.Invoke(context); // call next middleware
    // Write code here that will be executed after the
    //next middleware is called 
}

Map 系 扩大办法，比方：Map 和 MapWhen，它们罕用于给 pipeline 管道操作进行分流，前者是基于 Request path 进行分流，后者是基于指定的 谓语动词 进行分流。

上面的代码片段展现了如何应用 Map 办法对 Request Pipeline 进行分流。


public class Startup
{private static void MapRequestA(IApplicationBuilder app)
    {
        app.Run(async context =>
        {await context.Response.WriteAsync("This is MapRequestA");
        });
    }
    private static void MapRequestB(IApplicationBuilder app)
    {
        app.Run(async context =>
        {await context.Response.WriteAsync("This is MapRequestB");
        });
    }
    private static void MapRequestC(IApplicationBuilder app)
    {
        app.Run(async context =>
        {await context.Response.WriteAsync("This is MapRequestC");
        });
    }
    public void Configure(IApplicationBuilder app)
    {app.Map("/mapRequestPathA", MapRequestA);
        app.Map("/mapRequestPathB", MapRequestB);
        app.Map("/mapRequestPathB", MapRequestC);

        app.Run(async context =>
        {await context.Response.WriteAsync("Hello World!");
        });
    }
   //Other methods
}

MapWhen 办法承受两个参数:

Func<HttpContext, bool> predicate
delegate action

你能够在 Startup.Configure 办法中回绝 text/xml 格局的 request，如下代码所示：


        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {if (env.IsDevelopment())
            {app.UseDeveloperExceptionPage();
            }
            app.MapWhen(context => context.Request.ContentType.Equals
            ("text/xml", StringComparison.InvariantCultureIgnoreCase),
            (IApplicationBuilder applicationBuilder) =>
            {
                applicationBuilder.Run(async context =>
                {await Task.FromResult(context.Response.StatusCode = StatusCodes.Status406NotAcceptable);
                });
            });
            app.UseMvc();}

UseWhen 办法能够用于有条件的执行中间件, 上面的代码片段展现了如果以后 Request 申请门路是以 /api 结尾的话，执行一个指定的中间件，代码如下:


app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>
{applicationBuilder.UseCustomMiddleware();
});

请留神，UseWhen 不像 MapWhen，前者会继续执行前面的中间件逻辑，不论以后 UseWhen 的委托函数返回的是 true 还是 false，如果有点懵的话，能够了解一下上面的代码：


app.UseMiddlewareA();
app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>
{applicationBuilder.UseMiddlewareB();
});
app.UseMiddlewareC();

如果中间件没有短路，那么中间件 A 和 C 必定会被执行的，而且当申请门路是以 /api 结尾时，中间件 B 也会被调度。

在 ASP.Net Core 申请解决管道中有一个中间件链，所有申请和响应都流经此管道，当新申请达到时，这些中间件要么解决申请，要么将申请传递给管道中的下一个组件，对于更简单的申请解决，咱们能够应用 Map 和 MapWhen 办法来分流管道，并能够应用 UseWhen 有条件的执行中间件。

译文链接：https://www.infoworld.com/art…

更多高质量干货：参见我的 GitHub: csharptranslate

关于.net:如何在-ASPNet-Core-中使用-条件中间件

Use，Run，Map 办法介绍

注册中间件

Invoke 办法

分流 Http 管道

应用 UseWhen