ASP.NET5中间件

小的应用组件可以包含到Http请求管道当中，ASP.NET5 集成了中间件，被包在了应用程序的Configure方法当中。

1. 什么是中间件

中间件是一组被装到应用程序管道的请求和响应中的组件。每一个组件可以选择地是否把当前的请求传到下一个组件当中，可以执行一些特定的动作在下一个组件之前或者之后执行。请求委托被用来创建这样的请求管道，用来处理你应用程序的请求。

请求的委托用IApplicationBuilder的run, map, use扩展方法来配置. 在Starup的configure里面可以做这样的配置，一个单独的请求委托可以指定一个匿名的方法，或者定义在一个可重复利用的类当中。这些可重复利用的类就是中间件，或者中间组件。每个组件负责调用下一个组件，或者选择中止。

ASP.NET请求管道是由一系列的请求委托组成，一个一个地调用。如下图所示

每个委托有机会执行相应的操作在下一个委托之前或之后。任何的委托可以选择停止传递请求到下一个委托。这就是所谓的请求短路，这有时候有好的，可以避免一些不必要的工作，例如Authorization中间件在Authenticated之后调用之后的委托，当没有授权时会显示"Not Authorized"， 异常处理可以捕获到，因为它在管道中早执行了。

如下是应用程序的默认配置：

public void COnfigure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)

{

　　...

　　if(env.IsDevelopment())

　　{

　　　　app.UseBrowserLink();

　　　　app.UseDeveloperExceptionPage();

　　　　app.UseDatabaseErrorPage();　　

　　}

　　else

　　{

　　　　app.UseExceptionHandler("/Home/Error");

　　}

　　app.UseStaticFiles();

　　app.UseIdentity();

　　app.UseMvc(routes => {　routes.MapRout(name:"default", template:"{controller=Home}/{action=Index}/{id?}"　});

}

UseExceptionHandler最先配置，这样它可以处理后续调用出现的任何异常，另外，这里的设计让请求的静态文件不需要用户的认证，这样可以提升性能，

切记：在应用配置时利用中间件的顺序是很重要的，确保你的应用程序适合你的应用场景。

一个简单的匿名的调用如下：

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

注意，执行完上面的这条语句，就会中止执行下面的任何语句。

再看一个例子, 在委托的参数里可以增加一个next参数，来调用下一个委托。

public void ConfigureLogInline(IApplicationBuilder app, ILoggerFactory loggerfactory)

{

　　loggerfactory.AddConsole(minLevel: logLevel.Information);

　　var logger = loggerfactory.CreateLogger(_environment);

　　app.Use(async (context, next) => {logger.LogInfromation();

　　await next.Invoke();

　　logger.LogInformation("Finished handling request".);});

　　app.Run(async context=>{ await context.Response.WriteAsync("Hello from" + _environment); });

}

注意：不在要调用next之后再修改HttpResponse, 因为后续的委托也会写，导致错乱。

2 Run, Map, and Use

一般地， 我们用run的时候，是不会调用其它的组件的，也就是不会再调next的请求委托。所以，Run只能在最后被调用。

下面两个结果是一样的

public void COnfigureEnvironmentOne(IApplicationBuilder app)

{

　　app.Run(async context => { await context.Response.WriteAsync("Hello from " + _environment);

}

public void ConfigureEnvironmentTwo(IApplicationBuilder app)

{

　　app.Use(next => async context =>{ await context.Response.WriteAsync("Hello from " + _environment);

}

Map*扩展用来分支管道，下面会演示一个基于请求路径的分支，Map扩展用来把请求的路径和处理的方法做一个映射，例子如下：

private static void HandleMapTest(IApplicationBuilder app)

{

　　app.Run(async context => { await context.Response.WriteAsync("Map Test Successful"); });

}

public void ConfigureMapping(IApplicationBuilder app)

{

　　app.Map("/maptest", HandleMapTest);

}

MapWhen方法可以支持谓词的中间分支， 例如：

public void COnfigureMapWhen(IApplicationBuilder app)

{

　　app.MapWhen(context => { return context.Request.Query.ContainsKey("branch"); }, HandleBranch);

　　app.Run(async context => { awat context.Response.WriteAsync("Hello from " + _environment); });

}

private static void HandleBranch(IApplicationBuilder app)

{

　　app.Run(async context => { await context.Response.WriteAsync("Branch used."); });

}

上面的例子任何的请求参数中含有branch的都走HandleBranch分支，其它走下面的。

3. 内建的中间件

中间件　　　　　　描述

Authentication 　提供认证支持

CORS　　　　　　配置跨源资源共享

Diagnostics　　　包含错误页的支持和运行时的信息

Routing　　　　  定义限制请求的路由

Session 　　　　  提供管理用户会话的支持

Static Files　　     提供静态文件，文件夹的浏览

4. 编写中间件

对于复杂的请求处理，ASP.NET团队建议实现自己的中间件，在Configure里去调用，例如：

public class RequestLoggerMiddleware

{

　　private readonly RequestDelegate _next;

　　private readonly ILogger _logger;

　　public RequestLoggerMiddleware(RequestDelegate next, ILoggerFactory loggerFactory)

　　{

　　　　_next = next;

　　　　_logger = logggerFactory.CreateLogger<RequestLoggerMiddleware>();

　　}

　　public async Task Invoke(HttpContext context)

　　{

　　　　_logger.LogInformation("Handling request: " + context.Request.Path);

　　　　await _next.Invoke(context);

　　　　_logger.LogInformation("Finished handling request.");

　　}

}

public static class RequestLoggerExtensions

{

　　public static IApplicationBuilder UseRequestLogger(this IApplicationBuilder builder)

　　{

　　　　return builder.UseMiddleware<RequestLoggerMiddleware>();

　　}

}

在Configure方法中你可以简单地利用一行代码就搞定了。

app.UseRequestLogger();

在UseMiddleware<T>方法中ReuqestLoggerMiddleware的构造函数里的参数会被DI自动地注入进去。