探索ASP.NET Core中的IStartupFilter

原文：Exploring IStartupFilter in ASP.NET Core
做者：Andrew Lock
譯者：Lamond Lu

在本篇博客中，我將介紹一下IStartupFilter, 以及如何在ASP.NET Core中使用它。在下一篇博客中，我將介紹一下如何在外部中間件中使用IStartupFilter

IStartupFilter接口

IStartupFilter接口存在於Microsoft.AspNetCore.Hosting.Abstractions程序集中，它很是簡單，僅定義了一個接口方法。

namespace Microsoft.AspNetCore.Hosting
{
    public interface IStartupFilter
    {
        Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next);
    }
}

其中Configure方法返回了一個變量Action 。

當建立一個ASP.NET Core應用程序的時候，IApplicationBuilder負責配置ASP.NET Core的中間件管道。例如你能夠在Startup.cs文件的Configure方法中，看到如下相似的代碼。

public void Configure(IApplicationBuilder app)
{
    app.UseStaticFiles();

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

在這個方法中，你能夠直接使用方法提供的IApplicationBuilder參數，而且能夠向其中添加各類中間件。使用IStartupFilter, 你能夠指定並返回一個Action 類型的泛型委託，這意味你除了可使用方法提供的泛型委託配置IApplicationBuilder對象， 還須要返回一個泛型委託。

IStartupFilter方法能夠接受一個配置IApplicationBuilder的方法，換而言之IStartupFilter.Configure方法可使用Startup.Configure方法做爲參數。

例：

Startup _startup = new Startup();
Action<IApplicationBuilder> startupConfigure = _startup.Configure;

//後續會補充StartupFilter1類的代碼
IStartupFilter filter1 = new StartupFilter1(); 

Action<IApplicationBuilder> filter1Configure = filter1.Configure(startupConfigure)

//後續會補充StartupFilter2類的代碼
IStartupFilter filter2 = new StartupFilter2(); 

Action<IApplicationBuilder> filter2Configure = filter2.Configure(filter1Configure)

若是以前你學習過ASP.NET Core的中間件管道，對於這個代碼，你可能會感受很熟悉。這裏咱們正在創建另外一條管道， 它是一個Configure方法的管道，而不是中間件管道。 這就是IStartupFilter的目的，容許在應用程序中建立Configure方法的管道。

實現IStartupFilter接口的對象什麼時候會被調用?

如今咱們對IStartupFilter的簽名有了更進一步的理解，接下來咱們能夠看看它在ASP.NET Core框架中的用法。

要查看IStartupFilter是若是被調用的，你能夠在查看Microsoft.AspNetCore.Hosting程序集中的WebHost類。 當你在WebHostBuilder對象上調用Build方法時，實現IStartupFilter接口對象會被調用。 這個代碼一般出如今Program.cs文件中，例如：

public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()    
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseStartup<Startup>()
            .Build();  // 這個會調用BuildApplication方法

        host.Run(); 
    }
}

下面是BuildApplication方法的部分代碼，你能夠看到這個方法負責初始化中間件管道。方法的返回值RequestDelegate表示了一個完整的管道，當請求到達的時候，Kestral服務器能夠調用它。

private RequestDelegate BuildApplication()
{
    ..
    IApplicationBuilder builder = builderFactory.CreateBuilder(Server.Features);
    builder.ApplicationServices = _applicationServices;

    var startupFilters = _applicationServices.GetService<IEnumerable<IStartupFilter>>();
    Action<IApplicationBuilder> configure = _startup.Configure;
    foreach (var filter in startupFilters.Reverse())
    {
        configure = filter.Configure(configure);
    }

    configure(builder);

    return builder.Build();
}

首先，此方法建立IApplicationBuilder的實例，該實例將用於構建中間件管道，並將ApplicationServices設置爲已配置的DI容器。

接下來的代碼塊很意思。首先，從DI容器中獲取了一個集合IEnumerable<IStartupFilter。正如我前面說的那樣，咱們能夠配置多個IStartupFilter來造成一個管道，因此這個方法只是從容器中取出它們。此外，Startup.Configure方法被保存到局部變量configure中, 這就是一般在Startup類中編寫的Configure方法，用於配置中間件管道。

如今咱們經過循環遍歷每一個IStartupFilter（以相反的順序），傳入Startup.Configure方法，而後更新局部變量configure來建立Configure方法的管道。這種方式實現了一種嵌套管道的效果。例如，若是咱們有三個IStartupFilter實例，你最終會獲得相似這樣的東西，其中內部Configure方法在參數中傳遞給外部方法：

局部變量configure的最終值會被IApplicationBuilder調用來執行實際的中間件管道配置。 調用builder.Build方法以後會生成處理HTTP請求所需的RequestDelegate。

一個IStartupFilter的例子

前面我雖然描述了IStartupFilter的用途，可是可能查看一些現成的實現會更容易理解一些。 默認狀況下，WebHostBuilder在初始化時會註冊一個IStartupFilter - AutoRequestServicesStartupFilter

public class AutoRequestServicesStartupFilter : IStartupFilter
{
    public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next)
    {
        return builder =>
        {
            builder.UseMiddleware<RequestServicesContainerMiddleware>();
            next(builder);
        };
    }
}

本質上，它在中間件管道的開頭添加了一個額外的中間件，即RequestServicesContainerMiddleware。

這是惟一一個默認註冊的IStartupFilter，所以在這種狀況下，參數next將是Startup類的Configure方法。

這基本上就是IStartupFilter的所有內容 - 它是一種在配置的管道的開頭或結尾添加額外中間件（或其餘配置）的方法。

如何註冊IStartupFilter

註冊IStartupFilter很簡單，只需像往常同樣在你的ConfigureServices方法中註冊它。 默認狀況下，在WebHostBuilder中已經註冊了AutoRequestServicesStartupFilter

private IServiceCollection BuildHostingServices()
{
    ...
    services.AddTransient<IStartupFilter, AutoRequestServicesStartupFilter>();
    ...
}

RequestServicesContainerMiddleware中間件

如下是RequestServicesContainerMiddleware的部分代碼

public class RequestServicesContainerMiddleware
{
    private readonly RequestDelegate _next;
    private IServiceScopeFactory _scopeFactory;

    public RequestServicesContainerMiddleware(RequestDelegate next, IServiceScopeFactory scopeFactory)
    {
        _scopeFactory = scopeFactory;
        _next = next;
    }

    public async Task Invoke(HttpContext httpContext)
    {
        var existingFeature = httpContext.Features.Get<IServiceProvidersFeature>();

        if (existingFeature?.RequestServices != null)
        {
            await _next.Invoke(httpContext);
            return;
        }

        using (var feature = new RequestServicesFeature(_scopeFactory))
        {
            try
            {
                httpContext.Features.Set<IServiceProvidersFeature>(feature);
                await _next.Invoke(httpContext);
            }
            finally
            {
                httpContext.Features.Set(existingFeature);
            }
        }
    }
}

該中間件負責設置IServiceProvidersFeature。 建立時，RequestServicesFeature爲請求建立新的IServiceScope和IServiceProvider。 它將負責使用Scoped生命週期添加到DI容器的依賴項的建立和處理。

IStartupFilter的使用場景

通常來講，我不認爲在用戶的應用程序中須要使用IStartupFilter。 就其本質而言，用戶能夠在Configure方法中定義中間件管道，所以IStartupFilter是沒必要要的。

我能想到如下幾種須要使用IStartupFilter的場景：

• 你本身建立了一個庫，你須要確保你的中間件在中間件管道的開頭（或結尾）運行。
• 你正在使用一個使用IStartupFilter的庫，您須要確保您的中間件在它以前運行。

總結

本篇博文中，我講解了IStartupFilter以及WebHost如何使用它在構建中間件管道。 在下一篇文章中，我將探討IStartupFilter的具體用法。

後記

本篇是做者早期的一篇博文，我的覺着對IStartupFilter講解的比較清楚，就翻譯了一下。在做者的後期博文中，做者提供了許多IStartupFilter的使用場景，例如

• 在ASP.NET Core項目啓動前，使用IStartupFilter驗證強類型配置
• 在ASP.NET Core項目啓動前，使用IStartupFilter進行數據庫遷移和緩存預讀取

有興趣的同窗能夠本身閱讀一下，後續我會選擇一些有意思的文章翻譯一下。