我们将原有 ASP.NET 应用升级到 ASP.NET Core 的过程中, 会遇到一个新的概念: 中间件.
中间件是 ASP.NET Core 全新引入的概念. 中间件是一种装配到应用管道中以处理请求和响应的软件. 每个组件:
选择是否将请求传递到管道中的下一个组件.
可在管道中的下一个组件前后执行工作.
单独看以上中间件的定义, 一个很直观的感觉: 中间件是 HTTP 请求管道中的一层层的 AOP 扩展.
在展开介绍中间件之前, 我们先回顾一下 ASP.NET 中 HttpHandler 和 HttpModule 的处理方式.
一, ASP.NET 中 HttpHandler 和 HttpModule
先看一张图:
上图中有两个概念 HttpHandler 和 HttpModule, 其中:
HttpHandler 用于处理具有给定文件名或扩展名的请求. 比如上图中的. report 类的请求, 同时, 任何一个 HttpHandler 都需要实现接口 IHttpHandler, 都需要在 web.Config 配置文件中注册使用.
HttpModule 用于处理每个请求调用, 比如上图中的 Authorization Module, 每个 Http 请求都会经过 HttpModule 的处理. 通过 HttpModule 可以中断 Http 请求, 可以自定义 HttpResponse 返回. 同时, 任何一个 HttpModule 都需要实现接口 IHttpModule, 都需要在 Web.Config 配置文件中注册使用.
ASP.NET Core 引入了中间件来实现上面 2 种 Http 请求处理扩展. ASP.NET Core 中间件和 ASP.NET HttpHandler HttpModule 有什么区别?
二, ASP.NET Core 中间件和 ASP.NET HttpHandler HttpModule 的区别
1. 中间件比 HttpHandler,HttpModule 更简单
"模块","处理程序","Global.asax.cs", "WEB.CONFIG" (IIS 配置除外)和 "应用程序生命周期" 消失
中间件已使用 HttpHandler HttpModule 的角色
中间件使用代码而不是在 Web.config 中进行配置
通过管道分支, 可以将请求发送到特定的中间件, 不仅可以基于 URL, 还可以发送到请求标头, 查询字符串等.
2. 中间件类似于 HttpModule
处理每个请求调用
可以实现 Http 请求中间和继续
能够创建自定义的 HttpResponse
3. 中间件和 HttpModule 按不同的顺序处理
中间件的顺序取决于它们插入请求管道的顺序, 而模块的顺序主要基于应用程序生命周期事件
中间件中 Http 响应的顺序与 Http 请求的顺序相反, 而对于 HttpModule, 请求和响应的顺序是相同的.
三, ASP.NET Core 中间件的设计原理
ASP.NET Core 请求管道包含一系列请求委托, 依次调用. 下图演示了这一概念. 沿黑色箭头执行.
每个请求委托 (中间件) 都可以在下一个请求委托 (中间件) 之前和之后执行操作. 中间件中的异常处理委托应该在管道的早期被处理, 这样就可以捕获在管道后期发生的异常.
在 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 针对服务器应用无法识别的所有路由运行.
还有很多其他的内置中间件, 可以参考链接:. 如下图,
了解了 ASP.NET Core 内置的中间件之后, 我们可能需要自定义一些中间件, 比如说原有的 ASP.NET HttpModule 和 HttpHandler.
接下来第四部分, 我们继续示例:
四, 自定义中间件
将已有 HttpModule 用自定义中间件实现
先看一下原有 HttpModule 的一个实现:
- /// <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.
- }
- }
同时增加 IApplicationBuilder 的一个扩展方法:
- public static IApplicationBuilder UseCustomerMiddleware(this IApplicationBuilder builder)
- {
- return builder.UseMiddleware<CustomerMiddleware>();
- }
Startup 中使用这个中间件:
App.UseCustomerMiddlewares();
以上是对 ASP.NET Core 中中间件的技术由来整理和使用分享.
周国庆
2020/4/4
来源: https://www.cnblogs.com/tianqing/p/12633780.html