分层架构的引导加载程序

var scopeFactory = app.ApplicationServices.GetRequiredService<IServiceScopeFactory>();
using (var scope = scopeFactory.CreateScope())
{
    _bootstrapperLoader.TriggerConfigure(scope.ServiceProvider.GetRequiredService);
}

有一个注意事项是：由于我们不再从 UI 项目引用 Repository 项目，Visual Studio/msbuild 不会自动将 Repository dll 复制到 UI 项目的 bin 文件夹中。因此，为了解决这个问题，我在 UI 项目 BootstrapperLoaderDemo.csproj 中使用 PostBuild 目标，在构建后自动复制这些 dll。但是，为了使此 PostBuild 目标工作，我们需要确保 BootstrapperLoaderDemo 在其依赖项（BootstrapperLoaderDemo.Repository）完成构建后才进行构建。目前我不得不创建一个简单的 powershell/bash 脚本来单独构建项目，以确保维护该顺序。这是采用此库时最大的问题，但它只需要在开始时设置一次

<Target Name="PostPublish" AfterTargets="AfterPublish" >
  <ItemGroup>
    <ItemsToCopy Include="./../BootstrapperLoaderDemo.Repository/bin/$(Configuration)/$(TargetFramework)/publish/*" />
  </ItemGroup>
  <Copy SourceFiles="@(ItemsToCopy)" DestinationFolder="./bin/$(Configuration)/$(TargetFramework)/publish">
    <Output TaskParameter="CopiedFiles" ItemName="SuccessfullyCopiedFiles" />
  </Copy>
  <Message Importance="High" Text="PostPublish Target successfully copied:%0a@(ItemsToCopy->'- %(fullpath)', '%0a')%0a -&gt; %0a@(SuccessfullyCopiedFiles->'- %(fullpath)', '%0a')" />
</Target>

加载器配置

默认配置

默认情况下，BootstrapperLoader 具有以下设置

• 使用 FileSystemAssemblyProvider 在当前文件夹 (Directory.GetCurrentDirectory()) 中查找所有 *.dll
• BootstrapperLoader.TriggerConfigure 在上述 dll 中查找任何名为 Bootstrapper 的类中的 Configure() 方法
• BootstrapperLoader.TriggerConfigureContainer 在上述 dll 中查找任何名为 Bootstrapper 的类中的 ConfigureContainer() 方法
• Bootstrapper 类和 Configure()/ConfigureContainer() 可以是公共的或非公共的

LoaderBuilder 配置

加载器构建器通过 Fluent API 提供多种配置

• WithName("SomeBootstrapper")：查找名为 SomeBootstrapper 的类，而不是 Bootstrapper

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                      .ForClass()
                          .WithName("SomeBootstrapper")
                      .Build();
  </code>

• HasConstructorParameter<ISomeDependency>()：创建 Bootstrapper 实例时，使用接受 ISomeDependency 参数的构造函数

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                      .ForClass()
                          .HasConstructorParameter<ISomeDependency>(new SomeDependency())
                      .Build();
  </code>

• When(condition).CallConfigure("SomeConfigure")：调用 BootstrapperLoader.TriggerConfigure() 时，如果 condition 调用评估为 true，则除了 Configure() 之外，还调用 Bootstrapper 类中的 SomeConfigure() 方法

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                      .ForClass()
                          .When(env.IsDevelopment)
                              .CallConfigure("SomeConfigure")
                      .Build();
  </code>

• When(condition).CallConfigureContainer("SomeConfigureContainer")：调用 BootstrapperLoader.TriggerConfigureContainer() 时，如果 condition 调用评估为 true，则除了 ConfigureContainer() 之外，还调用 Bootstrapper 类中的 SomeConfigureContainer() 方法

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                      .ForClass()
                          .When(env.IsDevelopment)
                              .CallConfigureContainer("SomeConfigureContainer")
                      .Build();
  </code>

• When(condition).AddMethodNameConvention("Development")：当调用 BootstrapperLoader.TriggerConfigure()/ BootstrapperLoader.TriggerConfigureContainer() 时，如果 condition 调用评估为 true，则除了 Configure()/ConfigureContainer() 之外，还调用 Bootstrapper 类中的 SomeConfigure()/SomeConfigureContainer() 方法

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                      .ForClass()
                          .When(env.IsDevelopment)
                              .AddMethodNameConvention("Development")
                      .Build();
  </code>

• Use()：指定一个备用程序集提供程序

  示例

  <code>_bootstrapperLoader = new LoaderBuilder()
                          .Use(new FileSystemAssemblyProvider(Directory.GetCurrentDirectory(), "MyCoolProject*.dll")) //Look into current directory, grabs all dlls starting with MyCoolProject
                          .Build();
  </code>

您还可以创建新的 Assembly Provider 类，以自定义提供给加载器的程序集来源。目前，提供了两个类：FileSystemAssemblyProvider 和 InMemoryAssemblyProvider

从根项目触发引导程序

BootstrapperLoader 提供了 3 种方法来触发子项目 Bootstrapper 类中的方法

• TriggerConfigureContainer<TArg>(TArg parameter)

当根项目进行 IoC 注册时，应使用此方法。其参数通常是 IoC 容器或容器构建器。此方法将在 Bootstrapper 类中查找 ConfigureContainer 方法并传入参数，允许 Bootstrapper 类将其子项目的依赖项注册到 IoC 容器中

• TriggerConfigure(Func<Type, object> serviceLocator = null)

当执行任何非 IoC 配置/初始化（例如 AutoMapper 设置）的时机成熟时，应使用此方法。它可以带或不带 serviceLocator 参数调用

此方法接受 Func<Type, object> 作为其参数，以允许 Bootstrapper 类中的 Configure 方法接受任意数量的依赖项（只要这些依赖项可以使用 serviceLocator func 解析）。它的工作方式与 ASP.NET Core 中的 Startup.Configure 相同

此处使用 Func<Type, object> 是为了确保此库不依赖于任何特定的 IoC 容器。大多数 IoC 容器都应该支持具有此签名的 A 方法（例如，在 Autofac 中，它是 Resolve() 方法）

当不带 serviceLocator 参数调用时，它将仅在 Bootstrapper 类中查找 Configure() 方法（不带任何参数）

• Trigger<TArg>(string methodName, TArg parameter)

当调用此方法时，它将在子项目中的 Bootstrapper 类中查找具有指定名称的方法并调用它们，传入提供的参数。此方法适用于您的项目无法使用上述两种方法的任何其他情况。

库设计

仅当您对我是如何实现该库感兴趣时才阅读此部分

该库的主要逻辑非常简单，完全位于 BootstrapperLoader 类中。

它依赖于 LoaderConfig 来保存加载和触发引导程序类所需的所有信息（例如，引导程序类名、要查找的方法等）

在初始化期间，它查找包含 Bootstrapper 类的程序集，创建这些引导程序类的实例并将其存储在一个列表中。

当调用 Trigger() 方法时，它会在存储的引导程序类列表中查找具有指定名称的方法并调用它们

public void Trigger<TArg>(string methodName, TArg parameter)
{
    Bootstrappers.ForEach(bootstrapper =>
        ExecuteIfNotNull(
            bootstrapper.GetType()
                .GetMethod(methodName, MethodBindingFlags, null, new[] {typeof(TArg)}, null),
            methodInfo => methodInfo.Invoke(bootstrapper, new object[] { parameter }))
    );
}

我需要编写一个自定义方法 ExecuteIfNotNull()，而不是使用 C# 6 安全导航运算符，因为我希望我的库针对 .NET 4.5.2 以获得更广泛的受众。

TriggerConfigureContainer() 类似。Config.ConfigureContainerMethods 是一个字典，其中键是要查找的方法名，值是一个 Func<bool>，用于决定何时调用该方法

public void TriggerConfigureContainer<TArg>(TArg parameter)
{
    Bootstrappers.ForEach(bootstrapper =>
    {
        Config.ConfigureContainerMethods
            .Where(c => c.Value())
            .ToList()
            .ForEach(methodConfiguration => 
                ExecuteIfNotNull(
                    bootstrapper.GetType().GetMethod(methodConfiguration.Key, MethodBindingFlags, null, new[] {typeof(TArg)}, null),
                    methodInfo => methodInfo.Invoke(bootstrapper, new object[] { parameter }))
            );
    });
}

当调用 TriggerConfigure() 时，事情会变得更有趣一些

public void TriggerConfigure(Func<Type, object> serviceLocator = null)
{
    Bootstrappers.ForEach(bootstrapper =>
    {
        Config.ConfigureMethods
               .Where(c => c.Value())
               .ToList()
               .ForEach(methodConfiguration => 
                        ExecuteIfNotNull(
                            GetMethodInfoByName(bootstrapper.GetType(), methodConfiguration.Key, serviceLocator),
                            methodInfo => methodInfo.InvokeWithDynamicallyResolvedParameters(bootstrapper, serviceLocator))
                       );
    });
}

首先，它需要评估 Configure() 条件调用的条件，并且只选择条件评估为 true 的方法。其次，我有一个扩展方法 InvokeWithDynamicallyResolvedParameters() 用于调用这些方法

public static void InvokeWithDynamicallyResolvedParameters(this MethodInfo configureMethod, object bootstrapper, Func<Type, object> serviceLocator)
{
    var parameterInfos = configureMethod.GetParameters();
    var parameters = new object[parameterInfos.Length];
    for (var index = 0; index < parameterInfos.Length; index++)
    {
        var parameterInfo = parameterInfos[index];

        try
        {
            parameters[index] = serviceLocator(parameterInfo.ParameterType);
        }
        catch (Exception ex)
        {
            //Omitted for brevity
        }
    }

    configureMethod.Invoke(bootstrapper, parameters);
}

此方法的作用是遍历 Bootstrapper Configure() 方法的参数列表，并尝试使用提供的 serviceLocator 解析这些参数。如果您查看 ASP.NET Core 源代码，您会发现这与 ASP.NET Core 用于触发 Startup.Configure() 的逻辑几乎完全相同。我最初无法弄清楚如何做到这一点，所以我不得不查看 ASP.NET Core 的实现并“借鉴”了这个想法。

库中剩余的类用于为加载器构建器提供 Fluent API 配置。加载器构建器的唯一目的是让客户端为 LoaderConfig 指定不同的选项，并最终将其传递给 BootstrapperLoader。