Enum PollOutcome

pub enum PollOutcome {
    Leader {
        rank: Rank,
        transition: PollTransition,
    },
    Follower {
        owner: ParticipantId,
        rank: Rank,
        lease_duration: Duration,
    },
}

The role and fencing rank prepared by one poll transaction attempt.

The rank may protect work staged in the same transaction, but it authorizes no committed or external work until the enclosing Database::run succeeds.

Variants

Leader

The transaction staged this caller as owner with a fresh fencing rank.

PollTransition classifies how that staged ownership was reached.

Fields

rank: Rank

transition: PollTransition

Follower

A durable owner was observed, but no leadership transition was staged.

The fields form the exact record used to produce the next LocalState::Observation.

Fields

owner: ParticipantId

rank: Rank

lease_duration: Duration

Implementations

impl PollOutcome

pub fn is_leader(&self) -> bool

Returns whether this attempt staged an ownership transition.

pub fn rank(&self) -> Rank

Returns the observed or newly staged durable revision as a fencing rank.

Only Self::is_leader outcomes provide a new rank that can protect work staged by this poll transaction.

pub fn transition(&self) -> PollTransition

Returns the transition classification for this attempt.

PollOutcome::Follower always reports PollTransition::Followed.

pub fn is_takeover(&self) -> bool

Returns whether this attempt staged replacement of a foreign owner.

pub fn is_reacquisition(&self) -> bool

Returns whether this attempt staged reacquisition of this participant’s expired record.

pub fn owner(&self) -> Option<&ParticipantId>

Returns the observed owner when this attempt produced follower state.

The owner is an observation, not an authorization for the caller.

pub fn lease_duration(&self) -> Option<Duration>

Returns the observed persisted lease duration when following.

This duration is relevant to a later poll only with the matching Observation adopted by PollResult::into_next_state.

Trait Implementations

impl Clone for PollOutcome

fn clone(&self) -> PollOutcome

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PollOutcome

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

Formats the value using the given formatter.

impl PartialEq for PollOutcome

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PollOutcome

impl StructuralPartialEq for PollOutcome