Struct LifecycleContext 

pub struct LifecycleContext { /* private fields */ }

一次 Tick 的不可变 correlation 上下文。

with_* 方法均返回新值；调用方可以在 T1/T2/T3/T4/T5 间传递上下文， 不需要全局 carrier 或 task-local 状态。current_stage 的父阶段恒为 T1， 使同一 Tick 内的本地子树不会意外嵌套到前一个效果。

Implementations

impl LifecycleContext

pub fn new( tick_id: u64, parent_tick_id: Option<u64>, carrier: Option<TraceCarrier>, ) -> LifecycleContext

创建 T1 根上下文；网络能力默认关闭，避免缺能力时伪造 network span。

pub fn root( tick_id: u64, parent_tick_id: Option<u64>, carrier: Option<TraceCarrier>, ) -> LifecycleContext

创建带父 Tick 的 T1 上下文，作为 engine 的语义化构造别名。

pub const fn tick_id(&self) -> u64

返回当前 Tick 的独立 ID。

pub const fn parent_tick_id(&self) -> Option<u64>

返回上游 Tick ID；没有可证明的上游时保持 None。

pub fn carrier(&self) -> Option<&TraceCarrier>

返回显式 carrier 的只读引用。

pub fn span_parent(&self) -> Option<&TraceCarrier>

返回当前 Tick 内部 T1 span 的显式 parent carrier；没有 OTel 时保持 None。

pub fn with_span_parent( &self, span_parent: Option<TraceCarrier>, ) -> LifecycleContext

返回新的上下文并绑定本 Tick 的内部 span parent，不写入全局或 task-local 状态。

pub fn otel_parent(&self) -> Option<&TraceCarrier>

选择异步子节点的显式 parent；内部 T1 优先，外部 W3C carrier 仅作根回退。

pub const fn current_stage(&self) -> LifecycleStage

返回当前生命周期阶段。

pub const fn parent_stage(&self) -> LifecycleStage

返回当前阶段在 T1 根下的挂载点。

pub const fn stage_status(&self, stage: LifecycleStage) -> LifecycleStatus

读取五阶段状态，不会修改上下文。

pub fn with_stage_status( &self, stage: LifecycleStage, status: LifecycleStatus, ) -> LifecycleContext

设置阶段状态并返回新上下文。

pub const fn has_capability(&self, capability: LifecycleCapability) -> bool

读取能力是否存在。

pub const fn capability_status( &self, capability: LifecycleCapability, ) -> LifecycleStatus

读取能力状态；未提供能力时固定返回 NotApplicable。

pub fn with_capability( &self, capability: LifecycleCapability, enabled: bool, ) -> LifecycleContext

设置能力存在性；关闭能力时状态自动收敛到 NotApplicable。

pub fn with_capability_status( &self, capability: LifecycleCapability, status: LifecycleStatus, ) -> LifecycleContext

设置能力状态并返回新上下文；NotApplicable 会同时关闭该能力。

pub fn local_stage(&self, stage: LifecycleStage) -> LifecycleContext

构造同一 Tick 的局部阶段上下文，所有局部节点直接挂到 T1。

Trait Implementations

impl Clone for LifecycleContext

fn clone(&self) -> LifecycleContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LifecycleContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for LifecycleContext

fn default() -> LifecycleContext

创建 synthetic root，供无 Tick 的测试/启动 effect 使用。

impl Eq for LifecycleContext

impl PartialEq for LifecycleContext

fn eq(&self, other: &LifecycleContext) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for LifecycleContext