4 LifecycleRegistry 状态机详解

4.1 状态与事件枚举

LifecycleRegistry 依赖一个有限状态机（FSM）管理观察者通知。共有 5 个状态和 6 个事件，定义在 Lifecycle.State 与 Lifecycle.Event 中。

状态转换规则：向下前进需依次经过所有中间状态，向上回退则直接跳到目标状态（downgrade 会折叠中间状态）。

4.2 手工派发事件流程

通过 LifecycleRegistry.handleLifecycleEvent(Lifecycle.Event) 手工触发状态转换。内部流程：

1. 校验当前状态与事件是否合法（如从 RESUMED 不能直接发 ON_CREATE）。
2. 根据事件计算目标状态（getStateAfter(event)）。
3. 调用 moveToState(state)，沿备份的状态链向上或向下遍历。
4. 对每个中间状态通知所有观察者（Observer 的 onStateChanged 回调）。
5. 最终设置 mState = targetState。

// 典型手工派发示例（自定义 LifecycleOwner 内）
public class MyLifecycleOwner implements LifecycleOwner {
    private final LifecycleRegistry registry = new LifecycleRegistry(this);

    @NonNull @Override
    public Lifecycle getLifecycle() { return registry; }

    public void onMyCreate() {
        registry.handleLifecycleEvent(Lifecycle.Event.ON_CREATE);
    }
    public void onMyStart() {
        registry.handleLifecycleEvent(Lifecycle.Event.ON_START);
    }
    // ……
}

4.3 markState 与 setCurrentState 区别

markState 和 setCurrentState 都是 LifecycleRegistry 的方法，但语义完全不同。

// setCurrentState 会出发完整流程
registry.setCurrentState(State.CREATED);

// markState 只是赋值，不会通知观察者（常用于初始化阶段）
// markState 是 Package-private，外部通常无法调用
registry.markState(State.INITIALIZED); // 仅合法在 LifecycleRegistry 内部或测试中

4.4 自定义 LifecycleOwner 正确写法

正确的自定义 LifecycleOwner 应满足：

• 持有 LifecycleRegistry 实例并实现 getLifecycle()。
• 在生命周期关键节点调用 handleLifecycleEvent 或 setCurrentState。
• 支持 DefaultLifecycleObserver 或注解方式注册观察者。

import androidx.lifecycle.Lifecycle;
import androidx.lifecycle.LifecycleOwner;
import androidx.lifecycle.LifecycleRegistry;
import androidx.annotation.NonNull;

public class TimerOwner implements LifecycleOwner {
    private final LifecycleRegistry registry = new LifecycleRegistry(this);

    @NonNull @Override
    public Lifecycle getLifecycle() {
        return registry;
    }

    public void startTimer() {
        registry.setCurrentState(Lifecycle.State.STARTED);
    }

    public void stopTimer() {
        registry.setCurrentState(Lifecycle.State.CREATED);
    }

    public void destroy() {
        registry.setCurrentState(Lifecycle.State.DESTROYED);
    }
}

// 使用方式
TimerOwner owner = new TimerOwner();
owner.getLifecycle().addObserver(new DefaultLifecycleObserver() {
    @Override
    public void onStart(@NonNull LifecycleOwner lifecycleOwner) {
        System.out.println("Timer started");
    }
});
owner.startTimer(); // 触发 onStart