模块MoModule
概述
MoLibrary 是一个模块化的基础设施库，以 ASP.NET Core 为基础，大程度上解耦基础设施、库间的依赖，允许您单独使用某个模块而无需引入整个繁重的框架。
模块化是 MoLibrary 的核心设计理念，通过 MoModule 机制将基础设施划分为可独立使用的功能单元。
特性
- 统一直觉的注册方式：所有模块都遵循相同的注册和配置模式，上手简易。
- 自动中间件注册：只需配置依赖注入，无需手动注册中间件。
- 防止重复注册：所有模块都自动仅注册一次，不必担心服务或中间件重复注册。
- 高性能服务注册：对于需要反射的自动注册操作，在所有
MoModule注册过程中只遍历一次。 - 及时释放临时对象：减少注册阶段的内存占用。（如果普通方式进行注册，通常使用
static来贯穿服务注册及中间件阶段，而一般不会释放。） - 自动解决中间件顺序：无需手动管理中间件的注册顺序。
- 可视化依赖关系：及时提醒可能的注册失败、误操作等。
组成部分
MoModule作为库的核心注册机制，每个Library有一个或多个Module，每个Module组成如下：
Module{ModuleName}Option: 模块Option的设置Module{ModuleName}Guide: 模块配置的向导类Module{ModuleName}: 含有依赖注入的方式以及配置ASP.NET Core中间件等具体实现Module{ModuleName}BuilderExtensions: 面向用户的扩展方法
使用方式
开发者使用原生的方式注册Module，每个Module的方式都类似如下示例：
services.ConfigModuleAuthorization(Action<ModuleAuthorizationOption> option = null)
其中注册方法返回值为ModuleGuide，用于指引用户进一步配置模块相关功能
public class ModuleAuthorizationGuide
{
public ModuleGuideAuthorization AddPermissionBit<TEnum>(string claimTypeDefinition) where TEnum : struct, Enum
{
ConfigureExtraServices(nameof(AddPermissionBit), context =>
{
var checker = new PermissionBitChecker<TEnum>(claimTypeDefinition);
PermissionBitCheckerManager.AddChecker(checker);
context.Services.AddSingleton<IPermissionBitChecker<TEnum>, PermissionBitChecker<TEnum>>(_ => checker);
});
return this;
}
}
模块配置
为了提高开发者设置的优先级，在开发者AddMoModule的过程中，配置Option的Action设置如果不是模块第一次注册，仍会覆盖上一次的配置设置。这是因为模块的级联注册可能在开发者使用模块之前，已经进行了模块的配置。
如若有其他配置顺序需求，开发者可以使用以下扩展方法：
public TModuleGuideSelf ConfigureOption<TOption>(Action<TOption> extraOptionAction, EMoModuleOrder order = EMoModuleOrder.Normal) where TOption : IMoModuleOption<TModule>
来自模块级联注册的Option的优先级始终比用户Order低1，这是通过级联注册
GuideFrom判断实现的
模块级联注册
模块内部进行级联注册时可采用如下方法获取Guide类进行进一步配置。
protected TOtherModuleGuide DependsOnModule<TOtherModuleGuide>() where TOtherModuleGuide : MoModuleGuide, new()
{
return new TOtherModuleGuide()
{
GuideFrom = CurModuleEnum()
};
}
原理
MoDomainTypeFinder
用于获取当前应用程序相关程序集及搜索，可设置业务程序集。 用于Core扫描相关程序集所有类型进行自动注册、项目单元发现等，提高整个框架的性能。
ModuleBuilderExtensions
依赖注入背后的设置方式
public static ModuleAuthorizationGuide AddMoModuleAuthorization<TEnum>(this IServiceCollection services, string claimTypeDefinition) where TEnum : struct, Enum
{
return new ModuleAuthorizationGuide()
.AddDefaultPermissionBit<TEnum>(claimTypeDefinition);
}
MoModuleRegisterCentre
模块注册中心，用以控制整个模块注册生命周期。
注册流程
注册服务MoModuleRegisterServices
用户注册配置Module完毕后，在builder.Builder()之前调用MoModuleRegisterServices用于初始化注册MoModule
- 遍历模块注册请求上下文字典
ModuleRegisterContextDict，对于每个Key，代表存在一个Module类型模块的注册请求。 - 对于每个模块类使用默认配置（获取模块相关配置类使用反射创建实例）进行临时实例化，用于测试模块类，如果是
MoModuleWithDependencies则调用ClaimDependencies进一步填充ModuleRegisterContextDict。 - 再次重新遍历，对于每个模块注册请求信息，初始化模块相关配置类
InitFinalConfigures，用于构建真正的模块实例。
对于每个模块实例，按顺序调用如下方法：
ConfigureBuilderConfigureServicesPostConfigureServices：在执行遍历业务程序集类IWantIterateBusinessTypes后配置服务依赖注入
注册中间件 MoModuleUseMiddlewares
用户注册完服务后，开始配置应用程序管道时，应要调用MoModuleUseMiddlewares用于自动配置MoModule的中间件。
var app = builder.Build();
app.MoModuleUseMiddlewares(); // 在所有中间件构建之前配置
对于每个模块实例，按顺序调用如下方法：
ConfigureApplicationBuilder：配置应用程序管道
模块配置
模块配置包含模块本身配置ModuleOption及额外配置ModuleExtraOption，