.NET Core技术研究-中间件的由来和使用
今天
前言
选择是否将请求传递到管道中的下一个组件。 可在管道中的下一个组件前后执行工作。
"模块"、"处理程序"、" Global.asax.cs"、 "WEB.CONFIG" (IIS配置除外)和 "应用程序生命周期" 消失 中间件已使用HttpHandler HttpModule的角色 中间件使用代码而不是在 web.config 中进行配置 通过管道分支,可以将请求发送到特定的中间件,不仅可以基于 URL,还可以发送到请求标头、查询字符串等。
处理每个请求调用 可以实现Http请求中间和继续 能够创建自定义的HttpResponse
中间件的顺序取决于它们插入请求管道的顺序,而模块的顺序主要基于应用程序生命周期事件 中间件中Http响应的顺序与Http请求的顺序相反,而对于HttpModule,请求和响应的顺序是相同的。
包含一系列请求委托,依次调用。下图演示了这一概念。沿黑色箭头执行。
图片
每个请求委托(中间件)都可以在下一个请求委托(中间件)之前和之后执行操作。中间件中的异常处理委托应该在管道的早期被处理,这样就可以捕获在管道后期发生的异常。
在Startup.Configure 方法中添加中间件组件的顺序定义了针对请求调用这些中间件的顺序,以及响应的相反顺序。这个顺序对于安全性、性能和功能非常重要。
看一段示例代码:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
app.UseDatabaseErrorPage();
}
else
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
//app.UseCookiePolicy();
app.UseRouting();
// app.UseRequestLocalization();
// app.UseCors();
app.UseAuthentication();
app.UseAuthorization();
//app.UseSession();
app.UseEndpoints(endpoints =>
{
endpoints.MapRazorPages();
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
});
}
上述代码中每个中间件扩展方法都通过 Microsoft.AspNetCore.Builder 命名空间在 IApplicationBuilder 上公开。
app.Use***都是各种常用的内置中间件。比如:
1、异常处理类中间件。如上述代码中:
当应用在开发环境中运行时:异常显示页中间件 (UseDeveloperExceptionPage) 报告应用运行时错误。数据库错误页中间件报告数据库运行时错误。(app.UseDatabaseErrorPage();)
当应用在生产环境中运行时:异常处理程序中间件 (UseExceptionHandler) 捕获以下中间件中引发的异常。TTP 严格传输安全协议 (HSTS) 中间件 (UseHsts) 添加 Strict-Transport-Security 标头。
2、HTTPS 重定向中间件 (UseHttpsRedirection) 将 HTTP 请求重定向到 HTTPS。
3、静态文件中间件 (UseStaticFiles) 返回静态文件,并简化进一步请求处理。
4、Cookie 策略中间件 (UseCookiePolicy) 使应用符合欧盟一般数据保护条例 (GDPR) 规定。
5、用于路由请求的路由中间件 (UseRouting)。
6、身份验证中间件 (UseAuthentication) 尝试对用户进行身份验证,然后才会允许用户访问安全资源。
7、用于授权用户访问安全资源的授权中间件 (UseAuthorization)。
8、会话中间件 (UseSession) 建立和维护会话状态。如果应用使用会话状态,请在 Cookie 策略中间件之后和 MVC 中间件之前调用会话中间件。
9、用于将 Razor Pages 终结点添加到请求管道的终结点路由中间件(带有 MapRazorPages 的 UseEndpoints)。
10、对于单页应用程序 (SPA),SPA 中间件 UseSpaStaticFiles 通常是中间件管道中的最后一个。SPA 中间件处于最后的作用是:允许所有其他中间件首先响应匹配的请求。允许具有客户端侧路由的 SPA 针对服务器应用无法识别的所有路由运行。
还有很多其他的内置中间件,可以参考链接:https://docs.microsoft.com/en-us/aspnet/core/fundamentals/middleware/?view=aspnetcore-3.0。如下图,
/// <summary>/// 自定义HTTP扩展模块/// </summary>public class CustomerHttpModule : IHttpModule{ public void Init(HttpApplication context) { context.BeginRequest += Context_BeginRequest; } private void Context_BeginRequest(object sender, EventArgs e) { HttpApplication app = (HttpApplication)sender; // Do something } public void Dispose() { }}
/// <summary>/// 自定义中间件/// </summary>public class CustomerMiddleware{ private readonly RequestDelegate _next; public CustomerMiddleware(RequestDelegate next) { _next = next; } public async Task Invoke(HttpContext context) { // Do something with context near the beginning of request processing. await _next.Invoke(context); // Clean up. }}
public static IApplicationBuilderUseCustomerMiddleware(this IApplicationBuilder builder){ return builder.UseMiddleware<CustomerMiddleware>();}
app.UseCustomerMiddlewares();