原文出自:【ASP.NET Core快速入门】(八)Middleware管道介绍、自己动手构建RequestDelegate管道
中间件是汇集到以处理请求和响应的一个应用程序管道的软件。 每个组件:
- 可以选择是否要将请求传递到管道中的下一个组件。
- 之前和之后调用管道中的下一个组件,可以执行工作。
使用请求委托来生成请求管道。 请求委托处理每个 HTTP 请求。
请求中使用委托来配置运行,映射,和使用扩展方法。 一个单独的请求委托,它可将指定的在行作为匿名方法 (称为中,线中间件),或可以在可重用的类中定义它。 这些可重用的类和行在匿名方法中间件,或中间件组件。 在请求管道中的每个中间件组件负责调用管道中的下一个组件,或如果相应短路链。
使用 IApplicationBuilder 创建中间件管道
ASP.NET 核心请求管道由请求委托,调用一次是在另一个,如图所示 (执行如下所示的黑色箭头的线程) 的顺序组成:
我们可以链接多个请求委托连同app.use。 next
参数表示管道中的下一步委托。我们一共有两种办法构建管道:
然后执行dotnet build生成项目后执行 dotnet run 来运行我们我们的程序
如果我们在第二步的时候不调用Invoke会怎样?我们先执行 dotnet watch run
然后 我们再修改代码:
IApplicationBuilder是用来构建管道的,我们可以通过Use来注册中间件,同时可以传递给我们一个next的Deletegate的委托。在这个情况下,我们可以调用下一步中间件的委托,如果我们不调用的话,后面的管道就终止了。
还有一点就是IApplicationBuilder会提供给我们一个Map,我们可以理解为路由的机制。
我们后面的路由也是在这个基础上进行配置的。运行效果:
自己动手构建RequestDelegate管道
什么是RequestDelegate
ASP.NET Core的中间件通过一个类型Func<RequestDelegate, RequestDelegate>的委托对象来表示,而RequestDelegate也是一个委托,它代表一项请求处理任务。
每个中间件都承载着独立的请求处理任务,它本质上也体现了在当前HttpContext下针对请求的处理操作,那么为什么中间件不直接通过一个RequestDelegate对象来表示,而是表示为一个类型为Func<RequestDelegate, RequestDelegate>的委托对象呢?原因很简单,中间件并不孤立地存在,所有注册的中间件最终会根据注册的先后顺序组成一个链表,每个中间件不仅仅需要完成各自的请求处理任务外,还需要驱动链表中的下一个中间件。
对于一个由多个Func<RequestDelegate, RequestDelegate>对象组成的中间链表来说,某个中间件会将后一个Func<RequestDelegate, RequestDelegate>对象的返回值作为输入,而自身的返回值则作为前一个中间件的输入。某个中间件执行之后返回的RequestDelegate对象不仅仅体现了自身对请求的处理操作,而是体现了包含自己和后续中间件一次对请求的处理。那么对于第一个中间件来说,它执行后返回的RequestDelegate对象实际上体现了整个应用对请求的处理逻辑。
模拟RequestDelegate
首先先用VSCode新建一个控制台项目:MyPipeline,然后打开
dotnet new console --name MyPipeline
新建一个Context.cs类
using System; using System.Threading.Tasks; namespace MyPipeline { public class Context { } }
新建一个RequestDelegate.cs类
using System; using System.Threading.Tasks; namespace MyPipeline { public delegate Task RequestDelegate(Context context); }
在Program.cs中声明一个接收委托、返回委托的List,并初始化
public static List<Func<RequestDelegate,RequestDelegate>> _list=new List<Func<RequestDelegate,RequestDelegate>>();
//模拟ApplicationBuilder中的app.Use方法 public static void Use(Func<RequestDelegate,RequestDelegate> middleware) { _list.Add(middleware); }
在Main中调用
static void Main(string[] args) { //第一步 Use(next=>{ return context=>{ System.Console.WriteLine("1"); return next.Invoke(context); //return Task.CompletedTask; }; }); //第二步 Use(next=>{ return context=>{ System.Console.WriteLine("2"); return next.Invoke(context); }; }); RequestDelegate end=(context)=>{ System.Console.WriteLine("end..."); return Task.CompletedTask; }; _list.Reverse(); foreach(var middleware in _list) { end=middleware.Invoke(end); } //这时候我们没有Context,所以直接new一个Context给它 end.Invoke(new Context()); Console.ReadLine(); }
结果:
这个时候我们在第一步进行终止操作:
结果: