生命周期契约(Lifecycle/)
ILifecycle(生命周期持有者观测接口)
全部 LifecycleBase<THints> 派生类(数据结构基类 Log/Ring/Index/Metadata/Blob 与引擎
StorageEngine)实现——接口面只保留观测/等待契约:
IsReady(原子读,外部轮询自旋安全)/RecoveryState(状态快照)/RecoveryProgressChanged(进度事件)/WaitForReadyAsync/CancelRecovery。Initialize不在接口面——启动由各持有者自己的装配面提供(引擎 =StorageEngineBuilder.Start/StartAsync;结构 = 组合器/生成代码内部调用), 不允许外部经接口直接调 Initialize(判例:337 调用面消除——接口面启动 = 裸写状态机 与 LifecycleBase 闸门语义失同步)。- 与
IRecovery正交:ILifecycle = 持有者对外观测契约;IRecovery = 恢复算法契约 (可注入替换);LifecycleBase.Initialize内部委托IRecovery.Recover。
IRecovery(恢复规范接口)
- 状态/进度快照(原子读、只读——由实现内部推进);
RecoveryProgressChanged进度事件。 - 钩子序:
OnRecoveryStart(骨架起点)→RecoverAsync(hints)(唯一算法体)→OnRecoveryComplete(骨架终点);MarkReady(空盘/无需扫描场景)。 Reset()——重置为未恢复,允许再次RecoverAsync(hints)覆盖(重恢复/测试形态)。CancelRecovery()——显式取消通道(LifecycleBase 同时发 CTS.Cancel 信号兜底 + 本方法 显式通知):实现可停止扫盘、释放扫描资源——只靠 ct 轮询做不到。DIM 默认空操作。
状态机(RecoveryState / RecoveryPhase / RecoveryProgress)
RecoveryState:NotStarted → Recovering → Ready / Failed——Failed 重抛语义: 满套挂死 = 时序 bug,初始化返回时状态停在 NotStarted 即骨架未完成(判例在案)。RecoveryPhase:进度阶段枚举(观测恢复推进);RecoveryProgress:百分比+消息。EmptyHints:无恢复参数持有者的占位 hints struct。
反模式
- 经接口反射调
Initialize——启动入口已从接口面消除;走各自装配面(Builder/组合器)。 addr != Empty判"没有值"(见 存储契约 哨兵条)——本条的 生命周期对应物:轮询IsReady前不区分Failed(Failed 是终态重抛,不是"还没好")。- IRecovery 实现里吞取消——显式通道
CancelRecovery与 ct 双轨都要接。
源码:Lifecycle/(ILifecycle / IRecovery / RecoveryState / RecoveryPhase / RecoveryProgress / EmptyHints)。
行为面(骨架模板/钩子集/五步编排):lifecycle.md。