Struct RetainedAcknowledgementChain 

pub struct RetainedAcknowledgementChain {
    pub chain: BTreeMap<u64, (StoreAckRef, StoreAck)>,
    pub activating_commit: StoreBatchCommitRef,
    pub activating_commit_value: StoreBatchCommit,
}

A device’s acknowledgement chain, contiguous from sequence one, carried by a snapshot’s portable summary.

This is the one place the whole chain belongs. A device restoring from a snapshot has no retained rows to walk, so the summary has to state the contiguity itself; it is folded once per snapshot generation from the rows the snapshot covers, rather than rebuilt into every row.

Fields

chain: BTreeMap<u64, (StoreAckRef, StoreAck)>

activating_commit: StoreBatchCommitRef

activating_commit_value: StoreBatchCommit

Implementations

impl RetainedAcknowledgementChain

pub fn activated( activated: &RetainedVerifiedActivatedAck, activating_commit_value: &StoreBatchCommit, ) -> Self

Start a chain from the one acknowledgement a commit activated. Contiguity is not claimed yet: extend adds the rest, and validate_chain is what asserts the result runs from sequence one.

pub fn extend( &mut self, activated: &RetainedVerifiedActivatedAck, activating_commit_value: &StoreBatchCommit, ) -> bool

Fold one more retained acknowledgement in. A sequence already present must carry the same acknowledgement — two different ones at one sequence is a forked chain, not a longer one. The activating commit tracks the highest sequence, which is the one the summary reports.

pub fn latest(&self) -> Option<&(StoreAckRef, StoreAck)>

pub fn exactly_extends(&self, predecessor: &Self) -> bool

pub fn validate_chain( &self, root: &StoreRootRef, registration: &ReferencedStoreDeviceRegistration, ) -> Result<(), StoreProtocolError>

Trait Implementations

impl Clone for RetainedAcknowledgementChain

fn clone(&self) -> RetainedAcknowledgementChain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetainedAcknowledgementChain

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RetainedAcknowledgementChain

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RetainedAcknowledgementChain

fn eq(&self, other: &RetainedAcknowledgementChain) -> 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 Serialize for RetainedAcknowledgementChain

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RetainedAcknowledgementChain

impl StructuralPartialEq for RetainedAcknowledgementChain