using GFramework.Core.Abstractions.Architectures; using GFramework.Core.Abstractions.Enums; using GFramework.Core.Abstractions.Lifecycle; using GFramework.Core.Abstractions.Logging; using GFramework.Core.Abstractions.Model; using GFramework.Core.Abstractions.Systems; using GFramework.Core.Abstractions.Utility; namespace GFramework.Core.Architectures; /// /// 架构生命周期管理器 /// 负责管理架构的阶段转换、组件初始化和销毁 /// internal sealed class ArchitectureLifecycle( IArchitecture architecture, IArchitectureConfiguration configuration, IArchitectureServices services, ILogger logger) { #region Lifecycle Hook Management /// /// 注册生命周期钩子 /// /// 生命周期钩子实例 /// 注册的钩子实例 public IArchitectureLifecycleHook RegisterLifecycleHook(IArchitectureLifecycleHook hook) { return _phaseCoordinator.RegisterLifecycleHook(hook); } #endregion #region Component Lifecycle Management /// /// 统一的组件生命周期注册逻辑 /// /// 要注册的组件 public void RegisterLifecycleComponent(object component) { if (component is IInitializable initializable) { if (_initialized) throw new InvalidOperationException("Cannot initialize component after Architecture is Ready"); if (_pendingInitializableSet.Add(initializable)) { _pendingInitializableList.Add(initializable); logger.Trace($"Added {component.GetType().Name} to pending initialization queue"); } } _disposer.Register(component); } #endregion #region Phase Management /// /// 进入指定的架构阶段,并执行相应的生命周期管理操作 /// /// 要进入的下一个架构阶段 public void EnterPhase(ArchitecturePhase next) { _phaseCoordinator.EnterPhase(next); } #endregion #region Fields private readonly TaskCompletionSource _readyTcs = new(TaskCreationOptions.RunContinuationsAsynchronously); /// /// 待初始化组件的去重集合 /// private readonly HashSet _pendingInitializableSet = []; /// /// 存储所有待初始化的组件(统一管理,保持注册顺序) /// private readonly List _pendingInitializableList = []; /// /// 架构阶段协调器 /// private readonly ArchitecturePhaseCoordinator _phaseCoordinator = new(architecture, configuration, services, logger); /// /// 架构销毁协调器 /// private readonly ArchitectureDisposer _disposer = new(services, logger); /// /// 标记架构是否已初始化完成 /// private bool _initialized; #endregion #region Properties /// /// 当前架构的阶段 /// public ArchitecturePhase CurrentPhase => _phaseCoordinator.CurrentPhase; /// /// 获取一个布尔值,指示当前架构是否处于就绪状态 /// public bool IsReady => CurrentPhase == ArchitecturePhase.Ready; /// /// 获取一个布尔值,指示架构是否已初始化 /// public bool IsInitialized => _initialized; /// /// 阶段变更事件(用于测试和扩展) /// public event Action? PhaseChanged { add => _phaseCoordinator.PhaseChanged += value; remove => _phaseCoordinator.PhaseChanged -= value; } #endregion #region Initialization /// /// 初始化所有待初始化的组件 /// /// 是否使用异步模式 public async Task InitializeAllComponentsAsync(bool asyncMode) { logger.Info($"Initializing {_pendingInitializableList.Count} components"); // 按类型分组初始化(保持原有的阶段划分) var utilities = _pendingInitializableList.OfType().ToList(); var models = _pendingInitializableList.OfType().ToList(); var systems = _pendingInitializableList.OfType().ToList(); // 1. 工具初始化阶段 EnterPhase(ArchitecturePhase.BeforeUtilityInit); if (utilities.Count != 0) { logger.Info($"Initializing {utilities.Count} context utilities"); foreach (var utility in utilities) { logger.Debug($"Initializing utility: {utility.GetType().Name}"); await InitializeComponentAsync(utility, asyncMode); } logger.Info("All context utilities initialized"); } EnterPhase(ArchitecturePhase.AfterUtilityInit); // 2. 模型初始化阶段 EnterPhase(ArchitecturePhase.BeforeModelInit); if (models.Count != 0) { logger.Info($"Initializing {models.Count} models"); foreach (var model in models) { logger.Debug($"Initializing model: {model.GetType().Name}"); await InitializeComponentAsync(model, asyncMode); } logger.Info("All models initialized"); } EnterPhase(ArchitecturePhase.AfterModelInit); // 3. 系统初始化阶段 EnterPhase(ArchitecturePhase.BeforeSystemInit); if (systems.Count != 0) { logger.Info($"Initializing {systems.Count} systems"); foreach (var system in systems) { logger.Debug($"Initializing system: {system.GetType().Name}"); await InitializeComponentAsync(system, asyncMode); } logger.Info("All systems initialized"); } EnterPhase(ArchitecturePhase.AfterSystemInit); _pendingInitializableList.Clear(); _pendingInitializableSet.Clear(); _initialized = true; logger.Info("All components initialized"); } /// /// 异步初始化单个组件 /// /// 要初始化的组件 /// 是否使用异步模式 private static async Task InitializeComponentAsync(IInitializable component, bool asyncMode) { if (asyncMode && component is IAsyncInitializable asyncInit) await asyncInit.InitializeAsync(); else component.Initialize(); } #endregion #region Destruction /// /// 异步销毁架构及所有组件 /// public async ValueTask DestroyAsync() { await _disposer.DestroyAsync(CurrentPhase, EnterPhase); } /// /// 销毁架构并清理所有组件资源(同步方法,保留用于向后兼容) /// [Obsolete("建议使用 DestroyAsync() 以支持异步清理")] public void Destroy() { DestroyAsync().AsTask().GetAwaiter().GetResult(); } #endregion #region Ready State /// /// 标记架构为就绪状态 /// public void MarkAsReady() { EnterPhase(ArchitecturePhase.Ready); _readyTcs.TrySetResult(); } /// /// 标记架构初始化失败 /// /// 失败异常 public void MarkAsFailed(Exception exception) { EnterPhase(ArchitecturePhase.FailedInitialization); _readyTcs.TrySetException(exception); } /// /// 等待架构就绪 /// public Task WaitUntilReadyAsync() => _readyTcs.Task; #endregion }