中间件是组装到应用程序管道中以处理请求和响应的家伙,管道中的每一个组件都要知足如下两个条件app
在.Net Core 中,中间件的本质就是一个Func的委托,其中RequestDelegate的本质也是一个委托(经常听人说,要想进阶到高级开发,必需要搞清楚委托。看来不得不搞懂委托了,本文默认您已搞懂了?若是没搞懂怎么办呢?没关系,抽时间搞懂就好了),让咱们来看看它的定义(证实我没在吹牛)async
再来看看 RequestDelegate函数
接下来我尝试着解释下Func这个委托。咱们都知道 Func 这个 内置的委托学习
(我只截了与本文相关的一张图)ui
经过Func 这个截图的定义来看,它接受一个 T 返回一个 TResult ,结合咱们前面说的中间件来讲,它接受一个RequestDelegate,返回一个RequestDelegate。也就是说,每个中间件Func的传入参数RequestDelegate是下一个中间件的返回值,同时每个中间件Func的返回值是前一个中间件的传入参数。这样就构成了一串中间件链表,每当一个请求过来,都会按照中间件的注册顺序依次执行RequestDelegate中的内容,这就构成了ASP.NET Core中的请求管道。(好好理解这句话,这是真理呀,开个玩笑,这是我本人这么认为的。)spa
这里得上一张经典的图配合上一句真理来理解就不那么难了。翻译
好,咱们如今知道了Http请求处理管理是由多个Middleware组成的。可咱们上面从没提到Http相关的信息,如今让咱们看看它们是如何发生恋爱(产生关系的)?3d
仔细看了前文的话,你们应该注意到RequestDelegate的定义(仔细回想下),哎 估计大家都想起来了,对仍是上图咱们再学习下 code
此次我把这个家伙的定义到截到图里,咱们尝试着翻译下:A function that can process an HTTP request. 我将它翻译为:一个可以处理HTTP请求的 function(函数、方法)。是否是你们忽然间知道了,原来是这个家伙让它们与HTTP关联在一块儿的(产生了恋情)。中间件
好,若是你不信的话就让咱们来看看 HttpContext 这个家伙。为何要看这个家伙呢,由于它是 RequestDelegate 这个委托 接受的参数。
好了,这里不得不相信,.Net Core 的 Http 请求处理管道是由多个Middleware 组成的,而且 Middleware 与 Http 请求上下文 仅仅的关联在一块儿。
使用Use、Run和Map 配置HTTP管道。
您可使用Use、Run和Map 来配置HTTP管道,但各方法针对构建的中间件做用不一样.
Use:Use[Middleware]中间件负责调用管道中的下一个中间件,也可以使管道短路(即不调用 next 请求委托)。
Run:Run[Middleware]是一种约定,一些中间件组件可能会公开在管道末端运行的Run[Middleware]方法。
Map: Map扩展用做约定来建立管道分支, Map*建立请求管道分支是基于给定请求路径的匹配项。
public class Startup { public void Configure(IApplicationBuilder app) { app.Use(async (context, next) => { // Do work that doesn't write to the Response. await next.Invoke(); // Do logging or other work that doesn't write to the Response. }); app.Run(async context => { await context.Response.WriteAsync("Hello from 2nd delegate."); }); } }
Use将多个请求委托连接在一块儿,next 参数表示管道中的下一个委托,可经过不 调用 next 参数使管道短路。 一般可在下一个委托先后执行操做。
当委托不将请求传递给下一个委托时,它被称为“让请求管道短路” 。 一般须要短路,由于这样能够避免没必要要的工做。
Run委托终止管道。意思就是说,使用的Run 委托后,Run 下面的全部方法将不会被执行。
public class Startup { private static void HandleMap1(IApplicationBuilder app) { app.Run(async context => { await context.Response.WriteAsync("Map 1"); }); } private static void HandleMap2(IApplicationBuilder app) { app.Run(async context => { await context.Response.WriteAsync("Map 2"); }); } public void Configure(IApplicationBuilder app) { app.Map("/map1", HandleMap1); app.Map("/map2", HandleMap2); app.Run(async context => { await context.Response.WriteAsync("Hello from End Map delegate."); }); } }
执行与响应以下:
请求 | 响应 |
localhost:5000 | Hello from End Map delegate. |
localhost:5000/map1 |
Map 1 |
localhost:5000/map2 |
Map 2 |
1)、中间件(Middleware)是由IApplicationBuilder来构建的
2)、全部的代码截图都是 IApplicationBuilder F12后看到的
参考文章:https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/middleware/?view=aspnetcore-3.0
若是本文有描述不对的地方或者产生误导的地方,请及时反馈。