dotNET Core 3.X 请求处理管道和中间件的理解

理解 dotNET Core 中的管道模型,对我们学习 dotNET Core 有很大的好处,能让我们知其然,也知其所以然,这样在使用第三方组件或者自己写一些扩展时,可以避免入坑,或者说避免同样的问题多次入坑。

本文分为以下几个部分来进行介绍:

  • 新老管道模型对比

  • 分析代码理解请求处理

  • 中间件和过滤器的区别

  • 自定义中间件

新老管道模型对比

我们知道,在 Web 应用中,无论使用什么技术,都是客户端发送一个请求,服务器端经过一系列的处理后返回结果给客户端。

(图1)

在服务器端返回响应前我们的请求都会经过一些列的处理才会产生最终的结果,不管是之前的 dotNET Frameowrk 程序还是现在的 dotNET Core,中间的处理都采用了管道的设计。

ASP.NET 管道

通常,我们会将 ASP.NET 程序部署到 IIS 中,这样就形成了 IIS 和 ASP.NET 运行时的双管道模型,大致请求流程如下:

1、程序在 IIS 中运行后,会启动一个名为 w3wp.exe 的进程,我们进行服务器端 Debug 时就需要附加这个进程;
2、在 w3wp.exe 中利用 aspnet_isapi.dll 加载 .NET 运行时;
3、随后运行时 IsapiRuntime 会被加载,加载后,会接管整个 HTTP 请求,然后创建一个 IsapiWorkerRequest 对象来包装 HTTP 请求;
4、包装好 HTTP 请求后,将 IsapiWorkerRequest 传递给 ASP.NET 的 HttpRuntime ,这时请求就进入了 ASP.NET 的管道;
5、HttpRuntime 会根据 IsapiWorkerRequest 对象创建表示当前 HTTP 请求上下文 (Context) 对象 HttpContext;
6、HttpContext 创建后,HttpRuntime 会使用 HttpApplicationFactory 创建当前的 HttpApplication 对象,HttpApplication 对象会有多个,处理完后会被释放到 HttpApplication 的对象池中;
7、到了 HttpApplication 中之后,就是我们所熟悉的 HttpModule 和 HttpHandler 了,先经过 HttpModule ,比如 ASP.NET 自带的授权、身份认证、缓存等就是通过 HttpModule 处理,我们也可以自定义自己的 HttpModule ,而具体的 aspx、ascx 等就是由 HttpHandler 处理。

具体的处理流程图如下:

(图2)

HttpModule 和 HttpHandler 的细化图如下:

(图3)

dotNET Core 管道

在 dotNET Core 中,HttpModule 和 HttpHandler 已经消失了。取而代之的是 MiddleWare(中间件) 。在 Core 中请求处理管道由一个服务器和一组中间件来组成,服务器默认就是内置的 Kestrel ,官方经典的流程图如下:

(图4)

请求经过中间件处理完后,进入下一个中间件,然后按照顺序依次返回。相比较原来的 HttpModule ,更简单和轻量级,而且即便是系统级别的中间件,也是可以由用户自己选择使用的,更加灵活,同时也有更好的性能。更多中间件和 HttpModule 的对比可以参考:https://docs.microsoft.com/zh-cn/aspnet/core/migration/http-modules?view=aspnetcore-3.1

分析代码理解请求处理

控制台程序

在 Rider 中创建一个 dotNET Core 3.1 的控制台程序,修改项目文件如下:

<Project Sdk="Microsoft.NET.Sdk.Web"><PropertyGroup><TargetFramework>netcoreapp3.1</TargetFramework></PropertyGroup>
</Project>

控制台的 Skd 类型为 Microsoft.NET.Sdk ,将其修改为 Microsoft.NET.Sdk.Web 后会自动引用 ASP.NET Core 的相关包。这样这个控制台就有了 Web 应用的能力了,在 Program 类添加 using 引用:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Hosting;

Main 函数添加如下代码:

Host.CreateDefaultBuilder().ConfigureWebHost(builder => builder.Configure(app => app.Run(context => context.Response.WriteAsync("hello world!"))).UseKestrel().UseUrls("http://localhost:5000")).Build().Run();

运行程序,可以看到浏览器会显示 hello world

(图5)

Main 函数中的代码调用步骤如下:

  • 调用类 Host 的静态方法 CreateDefaultBuilder 创建一个 IHostBuilder,对象,在 CreateDefaultBuilder 方法中,系统帮我做了很多事情,比如设置根目录、加载配置文件、配置默认日志框架等;

  • 最终调用 IHostBuilder 的 Build 方法构建一个 IHost,并调用扩展方法 Run;

  • 在上面的 IHostBuilder 构建后,调用 ConfigureWebHost 方法对请求处理管道进行定制,该方法是 IHostBuilder 的一个扩展方法,接收一个 Action

    类型的委托,在该方法中,可以注册服务和使用中间件,比如上面例子中的 app.Run(context =&gt; context.Response.WriteAsync("hello world!")) 就是一个简单的中间件,中间件被注册到 Configure 方法的参数 Action<IApplicationBuilder> 委托中;
  • 随后调用 UseKestrel 来构建一个 Kestrel 的服务器,调用 UseUrls 方法来设置服务器监听的端口。

控制台程序到 Web API 的转变

如果我们创建的是一个 Web API 项目,在 Program 类中会有一个 CreateHostBuilder 的静态方法来返回 IHostBuilder 对象:

public static IHostBuilder CreateHostBuilder(string[] args) =>Host.CreateDefaultBuilder(args).ConfigureWebHostDefaults(webBuilder  =>{ webBuilder.UseStartup<Startup>(); });

上面代码中调用 webBuilder.UseStartup(); 加载了 Startup 类,Startup 类并没有继承任何类,但其实是按照 IStartup 接口的约束来实现的,IStartup 接口代码如下:

  public interface IStartup{IServiceProvider ConfigureServices(IServiceCollection services);void Configure(IApplicationBuilder app);}
  • ConfigureServices:用来注册服务;

  • Configure:用来加载中间件

既然 Configure 方法是用来注册中间件的,我们修改 Startup 类的 Configure 方法,可以实现和上面的控制台例子一样的效果:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{app.Run(context => context.Response.WriteAsync("hello world!"));
}

模拟多个中间件请求

在 Configure 中注册中间件通常使用 app.Use() 方法,Use 方法接收一个 Func<RequestDelegate, RequestDelegate> 的委托作为参数,这个委托即是我们的中间件,而 RequestDelegate 代表着 HTTP 请求的处理器,在整个请求处理中流转,RequestDelegate 的参数 HttpContext 包装了 HttpRequest 和 HttpResponse。

修改 Startup 类的 Configure 方法,代码如下:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{app.Use(next =>{Console.WriteLine("第一个中间件");return new RequestDelegate(async context =>{await context.Response.WriteAsync("First Middleware Begin >>>");await next.Invoke(context);await context.Response.WriteAsync($"First Middleware >>>");});});app.Use(next =>{Console.WriteLine("第二个中间件");return new RequestDelegate(async context =>{await context.Response.WriteAsync("Second Middleware Begin >>>");await context.Response.WriteAsync("Second Middleware End >>>");});});
}

先来看运行结果:

(图6)

(图7)

从图6 可以看出注册中间件的顺序和我们代码的顺序是相反的,这个看看 ApplicationBuilder 的源码就清楚,在 Build 方法中执行时将收集到的所有中间件进行了反转

(图8)

从图7 可以看出,中间件的执行顺序是按照注册的顺序一个一个进入,然后传递到后面一个中间件,最后一个执行完后原路返回。

中间件和过滤器的区别

我们可以在中间件中进行请求到拦截,做一些自己的处理,或者可以直接中断请求,同样 dotNET Core 中的 过滤器(Filter)也可以做同样的事情,那么两者有什么区别呢?

在之前的文章 《dotNET Core WebAPI 统一处理(返回值、参数验证、异常)》 中就是通过过滤器来实现返回值、异常等的统一处理,所以说过滤器跟 Controller 或者 Action 关系更紧密,是整个 MVC 这个中间件的一部分。

而中间件更多是关注业务无关的,比如 Session 存储、身份认证等。在 Web API 中经常使用 Swagger 来做文档管理,也是以中间件的方式来使用,添加如下代码就可以:

app.UseSwagger();
app.UseSwaggerUI(c =>
{c.SwaggerEndpoint("/swagger/v1/swagger.json", "DotNet Core WebAPI文档");
});

自定义中间件

实现自己的中间件,我们可以继承 IMiddleware 这个接口,可以看看这个接口的代码,只有一个方法需要实现:

public interface IMiddleware
{Task InvokeAsync(HttpContext context, RequestDelegate next);
}

现在来设定一个使用场景(不一定恰当),来使用自定义的中间件实现:

  • 项目是前后端分离的开发模式;

  • 接口需要只在当前站点中可以使用,脱离站点去调用是不允许的;

  • 假设当前站点为:http://fwhyy.com 。

1、创建 RequestSourceCheckMiddleware 类继承 IMiddleware ,并实现方法

public async Task InvokeAsync(HttpContext context, RequestDelegate next)
{string urlRef = context.Request.Headers["Referer"];if (string.IsNullOrWhiteSpace(urlRef) || !urlRef.Contains("http://fwhyy.com")){context.Response.StatusCode = 403; await Task.CompletedTask;}else{await next.Invoke(context);}
}

2、创建扩展方法

public static class RequestSourceCheckMiddlewareExtension
{public static IApplicationBuilder UseRequestSourceCheck(this IApplicationBuilder app){app.UseMiddleware<RequestSourceCheckMiddleware>();return app;}
}

3、在 Starup 类的 Configure 方法中调用扩展方法使用中间件

app.UseRequestSourceCheck();

4、调用结果如下

(图8)

实现中间件,我们也可以不继承 IMiddleware 接口,按照约束去定义中间件的类一样可以实现功能,在 dotNET Core 还有很多的地方使用着固有的约定,比如 Starup 类也没有实现 IStarup 接口,也是一样的道理。按照约定的方式实现代码如下:

public class RequestSourceCheckMiddlewareNew
{private readonly RequestDelegate _next;public RequestSourceCheckMiddlewareNew(RequestDelegate next){_next = next;}public async Task Invoke(HttpContext context){string urlRef = context.Request.Headers["Referer"];if (string.IsNullOrWhiteSpace(urlRef) || !urlRef.Contains("http://fwhyy.com")){ context.Response.StatusCode = 403; await Task.CompletedTask;}else{await  _next.Invoke(context);}}
}

希望本文对您有所帮助,下一篇准备讲讲 Web API 中 Jwt 的使用。

文中示例代码:https://github.com/oec2003/DotNetCoreThreeAPIDemo

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/310531.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

了解.NET中的垃圾回收

原文来自互联网&#xff0c;由长沙DotNET技术社区编译。尽管这是一篇来自2009年的古老的文章&#xff0c;但或许能够对你理解GC产生一些作用。 了解.NET中的垃圾回收一旦了解了.NET的垃圾收集器是如何工作的&#xff0c;那么可能会触及.NET应用程序的一些更为神秘的问题时&…

数据结构与算法--数组:二维数组中查找

数组 数组最简单的是数据结构&#xff0c;占据一整块连续的内存并按照顺序存储数据&#xff0c;创建数组时候&#xff0c;我们需要首先指定数组的容量大小&#xff0c;然后根据大小分配内存。即使我们只在数组中存储一个元素&#xff0c;亚需要为所有数据预先分配内存&#xf…

数据结构与算法--字符串:字符串替换

数据结构与算法–字符串&#xff1a;字符串替换 字符串的优化 由于字符串在编程时候使用的评率非常高&#xff0c;为了优化&#xff0c;很多语言都对字符串做了特殊的规定。下面我们讨论java中字符串的特性java中的字符数组以’\0’ 结尾&#xff0c;我们可以利用这个特性来找…

数据结构与算法--经典10大排序算法(动图演示)【建议收藏】

十大经典排序算法总结&#xff08;动图演示&#xff09; 算法分类 十大常见排序算法可分为两大类&#xff1a; 比较排序算法&#xff1a;通过比较来决定元素的位置&#xff0c;由于时间复杂度不能突破O(nlogn)&#xff0c;因此也称为非线性时间比较类排序非比较类型排序&…

如何查找,修复和避免C#.NET中内存泄漏的8个最佳实践

原文来自互联网&#xff0c;由长沙DotNET技术社区编译。本文来源&#xff1a;https://michaelscodingspot.com/find-fix-and-avoid-memory-leaks-in-c-net-8-best-practices/从事大型企业项目的任何人都知道内存泄漏就像是大型酒店中的老鼠。当它们很少时&#xff0c;您可能不会…

ASP.NET Core技术研究-探秘依赖注入框架

ASP.NET Core在底层内置了一个依赖注入框架&#xff0c;通过依赖注入的方式注册服务、提供服务。依赖注入不仅服务于ASP.NET Core自身&#xff0c;同时也是应用程序的服务提供者。毫不夸张的说&#xff0c;ASP.NET Core通过依赖注入实现了各种服务对象的注册和创建&#xff0c;…

Redis遍历方式思考--字典扩容方式

全量遍历keys 工作中线上Redis维护&#xff0c;有时候我们需要查询特定前缀的缓存key列表来手动处理数据。可能是修改值&#xff0c;删除key。那么怎么才能快速的从海量的key中查找到对应的前缀匹配项。Redis提供了一下简单的指令&#xff0c;例如keys用来满足特定正则下的key…

从项目到产品: 软件时代需要价值流架构师 | IDCF

译者&#xff1a;无敌哥原文地址: https://thenewstack.io/the-age-of-software-needs-value-stream-architects/ 本文翻译仅供学习交流之用。原文作者 Mik Kersten 出版了《Project to Product》本系列共四篇文章&#xff0c;分别是01 从项目到产品&#xff1a;软件需要从物理…

Redis高效性探索--线程IO模型,通信协议

Redis线程IO模型 Redis是单线程&#xff0c;这个毋庸置疑Redis单线程能做到这么高的效率&#xff1f;不用怀疑&#xff0c;还有很多其他的服务都是单线程但是也有超高的效率&#xff0c;比如Node.js&#xff0c;Nginx也是单线程。Redis单线程高效原因&#xff1a; Redis所有数…

Redis持久化-深入理解AOF,RDB

持久化 Redis数据全部在内存中&#xff0c;如果宕机&#xff0c;数据必然丢失&#xff0c;因此必须有一种机制保证Redis数据不会因为故障丢失&#xff0c;这就是Redis的持久化机制持久化方式两种&#xff1a;AOF&#xff0c;RDB&#xff0c;如下图 RDB快照模式是一次全量备份&…

推荐一个集录屏、截图、音频于一体的软件给大家

捕获屏幕&#xff0c;网络摄像头&#xff0c;音频&#xff0c;光标&#xff0c;鼠标单击和击键GitHub&#xff1a;https://github.com/MathewSachin/Captura特性 免费 100%免费&#xff0c;你不需要花一分钱开源 根据MIT许可的条款&#xff0c;可以在Github上获得Captura的源…

Redis高效性探索--管道

管道 开始接触Redis时候&#xff0c;对应Redis管道有一个错误认识&#xff0c;任务是redis服务器提供的一种特别的技术&#xff0c;有了这种技术可以加速Redis的存取效率&#xff0c;但是实际上Redis的管道计算&#xff08;Pipeline&#xff09;本身是客户端提供的技术&#x…

Redis--事务理解

事务 一个成熟的数据库系统一般都会有事务的支持&#xff0c;Redis作为一个缓存数据库也不例外&#xff0c;Redis的事务比之关系型数据库mysql&#xff0c;oracle等算比较简单的&#xff0c;Redis中无需理解那么多事务模型&#xff0c;可以直接使用。不过也正是因为简单&#…

.NET中的内存管理

原文来自互联网&#xff0c;由长沙DotNET技术社区编译。 .NET中的内存管理资源分配Microsoft .NET公共语言运行时要求从托管堆分配所有资源。当应用程序不再需要对象时&#xff0c;它们将自动释放。初始化进程后&#xff0c;运行时将保留地址空间的连续区域&#xff0c;该区域最…

Redis存储优化--小对象压缩

小对象压缩 Redis是一种内存数据库&#xff0c;内存是计算机中一种比较宝贵的资源&#xff0c;如果我们不注意节约&#xff0c;Redis很可能出现内存不足&#xff0c;最终导致崩溃。Redis为了优化数据结构的内存占用&#xff0c;增加了非常多的优化点&#xff0c;这些优化也是牺…

.Net微服务实战之技术架构分层篇

一拍即合上一篇《.Net微服务实战之技术选型篇》&#xff0c;从技术选型角度讲解了微服务实施的中间件的选择与协作&#xff0c;工欲善其事&#xff0c;必先利其器&#xff0c;中间件的选择是作为微服务的基础与开始&#xff0c;也希望给一直想在.Net入门微服务的同行有一个很好…

Redis高可用基石--主从同步

主从同步 当我们将Redis用于线上环境&#xff0c;单机肯定是不行的&#xff0c;即使不做集群&#xff0c;我们也应该做主从&#xff0c;有了主从&#xff0c;当主节点&#xff08;master&#xff09;挂掉时候&#xff0c;让运维将从节点&#xff08;slave&#xff09;接管&…

.NET 下基于动态代理的 AOP 框架实现揭秘

.NET 下基于动态代理的 AOP 框架实现揭秘Intro之前基于 Roslyn 实现了一个简单的条件解析引擎&#xff0c;想了解的可以看这篇文章 基于 Roslyn 实现一个简单的条件解析引擎执行过程中会根据条件的不同会在运行时创建一个类&#xff0c;每一次创建都会生成一个新的程序集&#…

C++实现链式基数排序

代码如下: #include <iostream> #include <cmath> using namespace std; typedef int KeyType; const int END -1; const int Radix 10;typedef struct Node {KeyType key;struct Node *next; };Node *CreateList() {KeyType x;Node *q nullptr;cin >> x…

Blazor WebAssembly 3.2.0 Preview 4 如期发布

ASP.NET团队如期3.16在官方博客发布了 Blazor WebAssembly 3.2.0 Preview 4&#xff1a;https://devblogs.microsoft.com/aspnet/blazor-webassembly-3-2-0-preview-4-release-now-available/ &#xff0c;同时在twitter上发了一条信息带上了下面这张图&#xff0c;这张图很形象…