Enum LifecycleOp 

pub enum LifecycleOp {
    Startup,
    FactoryReset,
    FabricRemoval {
        fab_idx: NonZero<u8>,
    },
}

A lifecycle operation delivered to a handler via Handler::lifecycle / AsyncHandler::lifecycle.

Unlike read/write/invoke - which are routed to the single handler matching the operation path - lifecycle operations are broadcast to every handler in the handler chain.

Variants

Startup

The node is starting up.

Delivered once, after the Data Model is constructed and before it starts serving operations.

The typical reaction is to populate the handler’s in-memory state from persisted storage (HandlerContext::kv) - the mirror image of the on-the-fly persistence the handler does while serving operations.

FactoryReset

The node is being factory-reset.

The typical reaction is to reset the handler’s in-memory state to factory defaults and remove the handler’s persisted data from HandlerContext::kv.

FabricRemoval

The fabric with the given local index has been removed from the node.

Delivered synchronously (via HandlerContext::notify_fabric_removed) right after the fabric is gone from the fabric table - via the RemoveFabric command, an AddNOC rollback, or a fail-safe expiry that did not resurrect a persisted (pre-UpdateNOC) copy of the fabric. NOT delivered when a fail-safe expiry reverts an in-progress UpdateNOC - the fabric is still commissioned in that case.

The typical reaction is to drop the removed fabric’s entries from any fabric-scoped state the handler owns outside the fabric table (a bindings registry, a scene table, provider lists, …) and re-persist. State stored inside the Fabric object itself (ACLs, group keys) needs no reaction - it is dropped with the fabric.

Like every lifecycle operation this is a broadcast, so multiple handler instances borrowing one shared registry each receive it - reactions must be idempotent (a retain-style purge naturally is).

Fields

fab_idx: NonZero<u8>

The local index the removed fabric had

Trait Implementations

impl Clone for LifecycleOp

fn clone(&self) -> LifecycleOp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LifecycleOp

impl Debug for LifecycleOp

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

Formats the value using the given formatter.

impl Eq for LifecycleOp

impl Hash for LifecycleOp

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for LifecycleOp

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LifecycleOp