.net core 中间件管道底层剖析

.net core 管道（Pipeline）是什么？

640?wx_fmt=jpeg

由上图可以看出，.net core 管道是请求抵达服务器到响应结果返回的中间的一系列的处理过程，如果我们简化一下成下图来看的话，.net core 的管道其实就是中间件的部分。微软中间件文档

640?wx_fmt=png

为什么管道就是中间件的部分了呢？我是这么理解的，.net core 是通过Startup 类配置服务和应用的请求管道，所以狭义点来讲这个管道就是指的请求管道，就是我们今天要理解的中间件管道。

.net core 核心体系结构的特点就是一个中间件系统，它是处理请求和响应的代码段。中间件彼此链接，形成一个管道。传入的请求通过管道传递，其中每个中间件都有机会在将它们传递到下一个中间件之前对它们进行处理。传出响应也以相反的顺序通过管道传递。

PS：简单来讲就是请求开始到响应结束的中间的一大部分。你可以理解成 " 汽车销售 " （开始买车到提车的过程，但愿不会坐在奔驰车盖上哭），哈哈……

还有我们来看看，为什么我们要简化来看，在运行时 .net core 会预先注入一些必要的服务及依赖项，默认注入（ServiceCollection）的服务清单如下：

640?wx_fmt=png

我们先断章取义地看，这里面有 Kestrel 处理请求，将接收到的请求内容（字符串流）转化成结构化的数据（HttpContext）供后面的中间件使用的服务。欸，服务哟。那其实也就是 Kestrel 服务也是中间件嘛。

而第一张图中的MVC本身也作为中间件来实现的。

还有一些相关的服务都可以看看上面截图的服务，而且旁边标注的生命周期的类型就是之前所讲到的 .net core 的三种注入模式。

那么从程序入口来讲，过程是怎么样的呢？

从应用程序主入口 Main() --> WebHost --> UseStartup

/// <summary>
/// Specify the startup type to be used by the web host.
/// </summary>
/// <param name="hostBuilder">The <see cref="T:Microsoft.AspNetCore.Hosting.IWebHostBuilder" /> to configure.</param>
/// <param name="startupType">The <see cref="T:System.Type" /> to be used.</param>
/// <returns>The <see cref="T:Microsoft.AspNetCore.Hosting.IWebHostBuilder" />.</returns>
public static IWebHostBuilder UseStartup(this IWebHostBuilder hostBuilder, Type startupType)
{
string name = startupType.GetTypeInfo().Assembly.GetName().Name;
return hostBuilder.UseSetting(WebHostDefaults.ApplicationKey, name).ConfigureServices((Action<IServiceCollection>)delegate(IServiceCollection services)
    {
if (typeof(IStartup).GetTypeInfo().IsAssignableFrom(startupType.GetTypeInfo()))
        {
            ServiceCollectionServiceExtensions.AddSingleton(services, typeof(IStartup), startupType);
        }
else
        {
            ServiceCollectionServiceExtensions.AddSingleton(services, typeof(IStartup), (Func<IServiceProvider, object>)delegate(IServiceProvider sp)
            {
                IHostingEnvironment requiredService = ServiceProviderServiceExtensions.GetRequiredService<IHostingEnvironment>(sp);
return new ConventionBasedStartup(StartupLoader.LoadMethods(sp, startupType, requiredService.get_EnvironmentName()));
            });
        }
    });
}

上面的代码就可以解释说，会预先注入的必要的服务，在通过委托的方式，注入 Startup 里的服务。具体可以继续探究：

UseSetting：Add or replace a setting in the configuration.

/// <summary>
/// Add or replace a setting in the configuration.
/// </summary>
/// <param name="key">The key of the setting to add or replace.</param>
/// <param name="value">The value of the setting to add or replace.</param>
/// <returns>The <see cref="T:Microsoft.AspNetCore.Hosting.IWebHostBuilder" />.</returns>
public IWebHostBuilder UseSetting(string key, string value)
{
    _config.set_Item(key, value);
return this;
}

ConfigureServices：Adds a delegate for configuring additional services for the host or web application. This may be called multiple times.

/// <summary>
/// Adds a delegate for configuring additional services for the host or web application. This may be called
/// multiple times.
/// </summary>
/// <param name="configureServices">A delegate for configuring the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection" />.</param>
/// <returns>The <see cref="T:Microsoft.AspNetCore.Hosting.IWebHostBuilder" />.</returns>
public IWebHostBuilder ConfigureServices(Action<IServiceCollection> configureServices)
{
if (configureServices == null)
    {
throw new ArgumentNullException("configureServices");
    }
return ConfigureServices(delegate(WebHostBuilderContext _, IServiceCollection services)
    {
        configureServices(services);
    });
}

ConventionBasedStartup

public class ConventionBasedStartup : IStartup
{
private readonly StartupMethods _methods;

public ConventionBasedStartup(StartupMethods methods)
    {
        _methods = methods;
    }

public void Configure(IApplicationBuilder app)
    {
try
        {
            _methods.ConfigureDelegate(app);
        }
catch (Exception ex)
        {
if (ex is TargetInvocationException)
            {
                ExceptionDispatchInfo.Capture(ex.InnerException).Throw();
            }
throw;
        }
    }

public IServiceProvider ConfigureServices(IServiceCollection services)
    {
try
        {
return _methods.ConfigureServicesDelegate(services);
        }
catch (Exception ex)
        {
if (ex is TargetInvocationException)
            {
                ExceptionDispatchInfo.Capture(ex.InnerException).Throw();
            }
throw;
        }
    }
}

OK，到这里就已经确定了，我们可控的是通过Startup注入我们所需的服务，就是Startup注入的中间件可以做所有的事情，如处理认证，错误，静态文件等等，并且如上面所说的 MVC 在 .net core 也是作为中间件实现的。

那么 .net core 给我们内置了多少中间件呢？如下图：

640?wx_fmt=png

我们很经常用到的内置中间件有：

    app.UseExceptionHandler(); //异常处理
    app.UseStaticFiles(); //静态文件
    app.UseAuthentication(); //Auth验证
    app.UseMvc(); //MVC

我们知道可以在启动类的 Configure 方法中配置 .net core 管道，通过调用 IApplicationBuilder 上的 Use*** 方法，就可以向管道添加一个中间件，被添加的顺序决定了请求遍历它们的顺序。因此，如上面添加内置中间件的顺序，传入的请求将首先遍历异常处理程序中间件，然后是静态文件中间件，然后是身份验证中间件，最终将由MVC中间件处理。

Use*** 方法实际上只是 .net core 提供给我们的“快捷方式”，以便更容易地构建管道。在幕后，它们最终都使用（直接或间接）这些关键字：Use 和 Run 。两者都向管道中添加了一个中间件，不同之处在于Run添加了一个终端中间件，即管道中的最后一个中间件。

那么有内置，就应该可以定制的。如何定制自己的中间件呢？上一些简陋的demo演示一下：

（1）无分支管道

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{

// Middleware A
       app.Use(async (context, next) =>
       {
            Console.WriteLine("A (before)");
await next();
            Console.WriteLine("A (after)");
       });

// Middleware B
       app.Use(async (context, next) =>
       {
            Console.WriteLine("B (before)");
await next();
            Console.WriteLine("B (after)");
       });

// Middleware C (terminal)
       app.Run(async context =>
       {
            Console.WriteLine("C");
await context.Response.WriteAsync("Hello world");
       });

}

打印结果：

A (before)
B (before)
C
B (after)
A (after)

那用管道图展示的话就是：

640?wx_fmt=png

（2）有分支管道，当使用无分支的管道时，相当于就是一条线直走到底再返回响应结果。但一般情况下，我们都希望管道更具灵活性。创建有分支的管道就需要使用到 Map 扩展用作约定来创建管道分支。Map 是基于给定请求路径的匹配项来创建请求管道分支的，如果请求路径以给定的路径开头，就执行分支。那么就有两种类型有分支的管道：

1.无连结分支，上官方demo：

public class Startup
{
private static void HandleMapTest1(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
await context.Response.WriteAsync("Map Test 1");
        });
    }

private static void HandleMapTest2(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
await context.Response.WriteAsync("Map Test 2");
        });
    }

public void Configure(IApplicationBuilder app)
    {
        app.Map("/map1", HandleMapTest1);

        app.Map("/map2", HandleMapTest2);

        app.Run(async context =>
        {
await context.Response.WriteAsync("Hello from non-Map delegate. <p>");
        });
    }
}

结果：

640?wx_fmt=png

以上无连结分支很容易就理解了，就是不同的路径跑不同的分支。如果是有参数匹配的话，就要使用 MapWhen，而 MapWhen 基于给定谓词的结果创建请求管道分支。Func<HttpContext, bool> 类型的任何谓词均可用于将请求映射到管道的新分支。谓词用于检测查询字符串变量 branch 是否存在。

2.有连结（重新连接上主管道）分支，创建有连结分支管道就要使用到 UseWhen，上demo：

public void Configure(IApplicationBuilder app)
{
    app.Use(async (context, next) =>
    {
        Console.WriteLine("A (before)");
await next();
        Console.WriteLine("A (after)");
    });

    app.UseWhen(
        context => context.Request.Path.StartsWithSegments(new PathString("/foo")),
        a => a.Use(async (context, next) =>
        {
            Console.WriteLine("B (before)");
await next();
            Console.WriteLine("B (after)");
        }));

    app.Run(async context =>
    {
        Console.WriteLine("C");
await context.Response.WriteAsync("Hello world");
    });
}

像上面的代码，当请求不是以 " /foo " 开头的时候，结果为：

当请求是以 " /foo " 开头的时候，结果为：

A (before)
B (before)
C
B (after)
A (after)

正如您所看到的，中间件管道背后的思想非常简单，但是非常强大。大多数功能都是 .net core(身份验证、静态文件、缓存、MVC等)作为中间件实现。当然，编写自己的代码也很容易！

后面可以进阶写自己的中间件，官方文档。

原文地址：https://www.cnblogs.com/Vam8023/p/10700254.html

.NET社区新闻，深度好文，欢迎访问公众号文章汇总 http://www.csharpkit.com
640?wx_fmt=jpeg

.net core 中间件管道底层剖析

相关文章

Codeforces Round #741 (Div. 2)

201609-5 祭坛

cf1562E. Rescue Niwen!

架构为什么要以领域为核心

201403-5 任务调度

cf1562D Two Hundred Twenty One

C# - 为引用类型重定义相等性 - 继承相关

201612-5 卡牌游戏

cf1562 C. Rings

微软百名员工签名力挺996.ICU

201512-5 矩阵

P1174 打砖块

包治百病 | 如何将一个.NET Core类库发布到NuGet

虚树简单例题

卡特兰数（简单说说）

如何在ASP.NET Core中使用Azure Service Bus Queue

NEC Programming Contest 2021 (AtCoder Beginner Contest 229)

2021银川Problem D. Farm(不保证正确性)

从B站的代码泄露事件中，我们能学到些什么？

Educational Codeforces Round 117 (Rated for Div. 2)