Struct LifecycleController 

pub struct LifecycleController { /* private fields */ }

The lifecycle controller embedded in every DatabaseCore (spec §10.1, S1A-004). It owns the state machine plus the in-flight operation counter that shutdown() drains against.

The controller is shared through an Arc so OperationGuards can be 'static and cross threads freely (a query worker may hold a guard long after the initiating handle returned).

Implementations

impl LifecycleController

pub fn new() -> Self

A controller in the Opening state: the core admits no operations until Self::mark_open completes initialization.

pub fn state(&self) -> LifecycleState

The current lifecycle state.

pub fn is_open(&self) -> bool

Whether the core currently admits new operations.

pub fn mark_open(&self)

Opening → Open. Called exactly once when core initialization finishes (recovery, WAL opening, open-generation advancement, and table mounting are done).

pub fn begin_shutdown(&self) -> bool

Open → Draining: the first shutdown() step. Returns true when this call initiated the drain; false when the core was already past Open (a concurrent or repeated shutdown), in which case the caller must not drive the remaining shutdown steps.

pub fn wait_drained(&self, deadline: Duration) -> Result<()>

Wait until every in-flight operation has drained or deadline elapses. The core stays in Draining either way; a timeout leaves the shutdown to the caller to retry or abandon.

pub fn mark_closing(&self)

Draining → Closing: operations have drained; durable sync, worker stop, and file-lock release happen in this state.

pub fn mark_closed(&self)

Closing → Closed: the final shutdown step.

pub fn poison(&self)

Any state → Poisoned: an unrecoverable internal error. Poison is terminal and sticky — a poisoned core never returns to Open.

pub fn begin_operation(self: &Arc<Self>) -> Result<OperationGuard>

Admit one operation (S1A-004: “every operation holds an OperationGuard”). New operations are rejected unless the core is Open; the returned guard releases its slot on drop.

pub fn active_operations(&self) -> u64

Number of operations currently holding a guard.

Trait Implementations

impl Debug for LifecycleController

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

Formats the value using the given formatter.

impl Default for LifecycleController

fn default() -> Self

Returns the “default value” for a type.