修改 Startup 加载 和Module 加载

This commit is contained in:
chfei committed 2026-09-23 18:47:54 +08:00
1 parent c732ecb1d2
commit c7fb447034
17 files changed
+462 -383

No files matched your search

+7 -32
View File
@@ -1,47 +1,22 @@
using MAX.Core.Interfaces;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;
namespace MAX.Framework.Interfaces
{
/// <summary>
/// 业务模块:把「服务注册」和「管道装配」两件事都交给模块自己,
/// 由宿主的两行代码统一驱动(模块不需要出现在 Program.cs 里):
/// <list type="number">
/// <item><c>builder.AddStoreHub()</c> → 自动发现所有模块并执行 <see cref="AddModule"/>(服务注册阶段,<c>Build()</c> 之前);</item>
/// <item><c>app.UseStoreHubModules()</c> → 自动执行 <see cref="UseModule"/>(管道阶段,<c>Build()</c> 之后、<c>Run()</c> 之前)。</item>
/// </list>
/// 模块实例由反射创建,因此实现类必须有无参构造函数。
/// </summary>
public interface IModule
public interface IModule : IPriority
{
/// <summary>
/// 模块执行顺序(数值越大越先执行),默认 <see cref="MAX.Core.Interfaces.IntPriority.Normal"/>。
/// 两个阶段都按这个顺序执行。
/// 添加Module
/// </summary>
int Priority => MAX.Core.Interfaces.IntPriority.Normal;
void AddModule(IHostApplicationBuilder host);
/// <summary>
/// 模块自己的配置文件(相对宿主输出目录 <see cref="AppContext.BaseDirectory"/>),
/// 例如 "appsettings.CloudProduct.json";默认 null 表示该模块没有独立配置文件。
/// 该文件由 <c>builder.AddStoreHub()</c> 自动并入宿主配置树(插在 appsettings*.json 之后、环境变量/命令行之前),
/// 因此模块内的服务照常注入 <c>IConfiguration</c> 就能读到自己的配置节,模块之间互不干扰。
/// 注意:只有 <c>builder.AddStoreHub()</c> 入口能加载模块配置文件,
/// 直接用 <c>builder.Services.AddStoreHub()</c> 时拿不到 IConfigurationBuilder,模块配置不会生效。
/// 管道装配阶段
/// </summary>
string? ConfigurationFile => null;
/// <summary>
/// 服务注册阶段(<c>builder.Build()</c> 之前):注册本模块的服务、选项、后台任务类型。
/// 需要读配置时用 <see cref="ModuleContext.Configuration"/>,不要再去碰 <c>builder</c>。
/// </summary>
void AddModule(ModuleContext context);
/// <summary>
/// 管道装配阶段(<c>builder.Build()</c> 之后、<c>app.Run()</c> 之前):
/// 注册中间件(如 Hangfire 看板)、Map 端点、读取 <see cref="WebApplication.Services"/> 解析服务、注册启动任务等。
/// 不需要管道装配的模块可以不实现(默认空实现)。
/// </summary>
void UseModule(WebApplication app)
{
}
void UseModule(IApplicationBuilder app);
}
}
@@ -1,26 +0,0 @@
using MAX.Core.Interfaces;
using Microsoft.AspNetCore.Builder;
namespace MAX.Framework.Interfaces
{
/// <summary>
/// 模块基类:给出 <see cref="IModule.Priority"/> 与 <see cref="IModule.UseModule"/> 的默认实现,
/// 模块只需重写自己真正关心的阶段(只有服务注册时只写 <see cref="AddModule"/>)。
/// </summary>
public abstract class ModuleBase : IModule
{
/// <inheritdoc />
public virtual int Priority => IntPriority.Normal;
/// <inheritdoc />
public virtual string? ConfigurationFile => null;
/// <inheritdoc />
public abstract void AddModule(ModuleContext context);
/// <inheritdoc />
public virtual void UseModule(WebApplication app)
{
}
}
}
@@ -1,46 +0,0 @@
using MAX.Core.DependencyInjection;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
namespace MAX.Framework.Interfaces
{
/// <summary>
/// 模块上下文:模块在「服务注册阶段」能拿到的全部宿主信息。
/// 之所以包成一个对象,是为了以后要再补宿主的其他东西(日志、配置节、HostApplicationBuilder 等)时不用改接口签名。
/// </summary>
public sealed class ModuleContext
{
public ModuleContext(
IServiceCollection services,
IServiceRegistrar registrar,
IConfiguration configuration,
IHostEnvironment? environment = null)
{
Services = services;
Registrar = registrar;
Configuration = configuration;
Environment = environment;
}
/// <summary>
/// 服务集合(Microsoft.Extensions.DependencyInjection),等价于宿主里的 <c>builder.Services</c>
/// </summary>
public IServiceCollection Services { get; }
/// <summary>
/// 容器无关的注册器,等价于 <see cref="IStartup.Register"/> 里拿到的那个,便于以后换容器
/// </summary>
public IServiceRegistrar Registrar { get; }
/// <summary>
/// 应用配置,等价于宿主的 <c>builder.Configuration</c>(永不为 null;走旧的无参入口时是空配置)
/// </summary>
public IConfiguration Configuration { get; }
/// <summary>
/// 宿主环境,等价于宿主的 <c>builder.Environment</c>;走旧的无参入口时为 null
/// </summary>
public IHostEnvironment? Environment { get; }
}
}