Cuture.Extensions.Modularity

1. Intro

围绕 Microsoft.Extensions.DependencyInjection.Abstractions 为核心的.Net模块化开发库.

2. Features

• 支持异步的模块配置方法；
• 支持基于特性标注的服务自动注入（默认不支持基于继承的服务自动注入）；
• 基本和Abp的模块实现方法相同；
• 可拓展的模块加载源，已实现基于Type、Assembly、File、Directory的模块加载；
• IOptions<TOptions>自动绑定；
• 可集成其它模块系统的模块（如Abp），详见示例代码；
• 主项目只依赖Microsoft.Extensions.DependencyInjection.Abstractions，Hosting项目额外依赖Hosting.Abstractions、Configuration.Binder、Options；
• Mermaid生成工具，方便查看模块依赖关系；

Nuget包列表

Package	Description
Cuture.Extensions.Modularity	模块化的核心库
Cuture.Extensions.Modularity.Hosting	对Host的模块化支持库，用于在通用主机中加载模块

3. 如何使用

3.1 安装Nuget包

Install-Package Cuture.Extensions.Modularity

3.2 实现一个模块

[DependsOn( typeof(DependsSampleModule1), typeof(DependsSampleModule2) )] //定义依赖的模块 [AutoRegisterServicesInAssembly] public class SampleModule : AppModule { public override void ConfigureServices(ServiceConfigurationContext context) { //进行模块需要的配置 } }

• [DependsOn]：声明此模块依赖的模块，加载顺序与声明顺序相同;（可选）
• [AutoRegisterServicesInAssembly]：有此特性的模块将会自动将所在程序集中使用ExportServices标记的导出服务注入到DI容器;（可选）
  • 1.1.6之后默认自动注册，使用[DisableAssemblyServicesRegister]特性进行手动关闭
• 继承AppModule：标准的模块只需要继承IAppModule即可。如果需要单独的配置，则可以单独实现IPreConfigureServices、IConfigureServices、IPostConfigureServices、IOnPreApplicationInitialization、IOnApplicationInitialization、IOnPostApplicationInitialization、IOnApplicationShutdown以在对应的时机进行配置，或直接继承AppModule并重写对应的方法；所有方法都有异步版本IPreConfigureServicesAsync、IConfigureServicesAsync、IPostConfigureServicesAsync、IOnPreApplicationInitializationAsync、IOnApplicationInitializationAsync、IOnPostApplicationInitializationAsync、IOnApplicationShutdownAsync，或直接继承AsyncAppModule；

3.3 直接通过DI容器使用模块

可能需要安装Microsoft.Extensions.DependencyInjection包，视主项目而定

var services = new ServiceCollection(); //加载模块 services.LoadModule<SampleModule>() //直接从类型加载 .LoadModuleFile(modulePath) //从文件加载 .LoadModuleDirectory(source => { source.SearchDepth = 5; //设置文件夹搜索深度 }, moduleDirectory) //从文件夹加载 .ModuleLoadComplete() //必须调用此方法，以确认模块加载完成 using (var serviceProvider = services.BuildServiceProvider()) { //必须调用此方法，以初始化模块 serviceProvider.InitializationModulesWithOutHostLifetime(); //这里使用初始化了模块的serviceProvider //关闭模块 serviceProvider.ShutdownModules(); }

Note:

• 直接使用DI容器时，不会在控制台等关闭时，自动调用模块结束方法（使用Host时会），需要手动调用；

3.4 通过通用主机使用模块 (Console、Asp .net Core...)

1. 安装Hosting拓展库

Install-Package Cuture.Extensions.Modularity.Hosting

2. 在主机构建时配置模块加载

Host.CreateDefaultBuilder(args) .LoadModule<SampleModule>() //直接从类型加载 .LoadModuleFile(modulePath) //从文件加载 .LoadModuleDirectory(source => { source.SearchDepth = 5; //设置文件夹搜索深度 }, moduleDirectory) //从文件夹加载 .UseConsoleLifetime() .InitializationModules() //必须调用此方法，以初始化模块 .Run();

• 也可以通过配置主机DI容器的方法来使用

更多细节详见示例代码；

3.5 服务导出

• 需要为类型所在程序集的模块标记特性[AutoRegisterServicesInAssembly]

[ExportServices(ServiceLifetime.Singleton, AddDIMode.Replace, typeof(IHello))] public class Hello : IHello { public string SayHello() { return "Hello"; } }

示例代码会自动将Hello类型以单例模式注册为IHello服务，并在注入时使用Replace方法。

参数：

• ServiceLifetime：注册的生命周期类型；
• AddDIMode：注册的方法，包括Add、TryAdd、Replace；

除示例的ExportServices外，还有ExportSingletonServices、ExportScopedServices、ExportTransientServices等多个拓展特性的重载实现；

IOptions<TOptions>自动绑定

• 自动查找模块中继承了IOptions<TOptions>的类；
• 使用其完整名称为路径，在IConfiguration查找节点，并绑定值；
• 如 A 类命名空间为 B.C.D.E.F ，则IConfiguration查找路径为 B:C:D:E:F:A；
• Note: 构建过程中必须有可访问的IConfiguration !!! 详见示例项目；

示例配置代码:

• 在构建中调用 AutoBindModuleOptions() 方法即可；

Host.CreateDefaultBuilder(args) .ConfigureHostConfiguration(builder => builder.AddJsonFile("appsettings.Development.json")) .LoadModule<HostSampleModule>() .AutoBindModuleOptions() //自动使用 IConfiguration 绑定模块中继承了 IOptions<TOptions> 的类 .UseConsoleLifetime() .InitializationModules() .Run();

集成其它模块系统的模块

参考示例项目OtherModuleSystemAdaptSample

其它

获取依赖的Mermaid字符串

var abpModuleDescriptors = AppModuleDependencyUtil.FindAllDependedModuleDescriptors(typeof(XXXModule)); var mermaidString = abpModuleDescriptors.ToMermaidString();

然后将mermaidString复制到支持mermaid的编辑器就能查看模块依赖关系了。