Table of Contents

生命周期契约(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。

反模式

  1. 经接口反射调 Initialize——启动入口已从接口面消除;走各自装配面(Builder/组合器)。
  2. addr != Empty 判"没有值"(见 存储契约 哨兵条)——本条的 生命周期对应物:轮询 IsReady 前不区分 Failed(Failed 是终态重抛,不是"还没好")。
  3. IRecovery 实现里吞取消——显式通道 CancelRecovery 与 ct 双轨都要接。

源码:Lifecycle/(ILifecycle / IRecovery / RecoveryState / RecoveryPhase / RecoveryProgress / EmptyHints)。 行为面(骨架模板/钩子集/五步编排):lifecycle.md。