小白开学Asp.Net Core 《七》

　　　　　　— — 探究中间件（MiddleWare）

1、何为中间件？

　　中间件是组装到应用程序管道中以处理请求和响应的家伙，管道中的每个组件都要满足以下两个条件

选择是否将请求传递给管道中的下一个组件
可以在调用管道中的下一个组件之前和之后执行工作。

2、中间件的本质

　在.Net Core 中，中间件的本质就是一个Func的委托，其中RequestDelegate的本质也是一个委托（常常听人说，要想进阶到高级开发，必须要搞清楚委托。看来不得不搞懂委托了，本文默认您已搞懂了？如果没搞懂怎么办呢？不要紧，抽时间搞懂就行了），让我们来看看它的定义（证明我没在吹牛）

再来看看 RequestDelegate

接下来我尝试着解释下Func这个委托。我们都知道 Func 这个内置的委托

（我只截了与本文相关的一张图）

　通过Func 这个截图的定义来看，它接受一个 T 返回一个 TResult ，结合我们前面说的中间件来说，它接受一个RequestDelegate，返回一个RequestDelegate。也就是说，每一个中间件Func的传入参数RequestDelegate是下一个中间件的返回值，同时每一个中间件Func的返回值是前一个中间件的传入参数。这样就构成了一串中间件链表，每当一个请求过来，都会按照中间件的注册顺序依次执行RequestDelegate中的内容，这就构成了ASP.NET Core中的请求管道。（好好理解这句话，这是真理呀，开个玩笑，这是我本人这么认为的。）

这里得上一张经典的图配合上一句真理来理解就不那么难了。

　　好，我们现在知道了Http请求处理管理是由多个Middleware组成的。可我们上面从没提到Http相关的信息，现在让我们看看它们是如何发生恋爱（产生关系的）？

　　仔细看了前文的话，大家应该注意到RequestDelegate的定义（仔细回想下），哎估计你们都想起来了，对还是上图我们再学习下

这次我把这个家伙的定义到截到图里，我们尝试着翻译下：A function that can process an HTTP request. 我将它翻译为：一个能够处理HTTP请求的 function（函数、方法）。是不是大家突然间知道了，原来是这个家伙让它们与HTTP关联在一起的（产生了恋情）。

好，如果你不信的话就让我们来看看 HttpContext 这个家伙。为什么要看这个家伙呢，因为它是 RequestDelegate 这个委托接受的参数。

好了，这里不得不相信，.Net Core 的 Http 请求处理管道是由多个Middleware 组成的，并且 Middleware 与 Http 请求上下文仅仅的关联在一起。

　　使用Use、Run和Map 配置HTTP管道。

3、Use、Run和Map

　　您可以使用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

4、总结

　　1）、中间件（Middleware）是由IApplicationBuilder来构建的

　　2）、所有的代码截图都是 IApplicationBuilder F12后看到的

5、说明

　　参考文章：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/middleware/?view=aspnetcore-3.0

　　如果本文有描述不对的地方或者产生误导的地方，请及时反馈。