Struct CutoverContext 

pub struct CutoverContext { /* private fields */ }

What a participant hook is told about the cutover it is part of.

Implementations

impl CutoverContext

pub fn id(&self) -> &str

The cutover id (random, fresh for each attempt, persisted in the record).

pub fn generation(&self) -> u64

The generation number: 1 for the first attempt at this new root, one more for each rerun after an abort or an interruption. A service can fence stale replies with it.

pub fn old_root(&self) -> &Path

The canonical old root. Participants must treat it as read-only.

pub fn new_root(&self) -> &Path

The canonical new root.

pub fn resumed(&self) -> bool

True when this attempt follows an earlier one that did not complete, or finishes a switched cutover after a restart. Hooks must be idempotent: work an earlier attempt already finished is verified, not redone or refused.

pub fn authoritative(&self, settlement: Settlement) -> &Path

The root a participant must be using after settlement.

Trait Implementations

impl Clone for CutoverContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CutoverContext

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

Formats the value using the given formatter.