Enum PreconditionFailure 

pub enum PreconditionFailure {
    Present {
        collection: String,
        key: String,
    },
    Missing {
        collection: String,
        key: String,
    },
    Version {
        collection: String,
        key: String,
        expected: u64,
        actual: u64,
    },
    Epoch {
        collection: String,
        key: String,
        expected: u64,
        actual: u64,
    },
    Lease {
        collection: String,
        key: String,
        expected: String,
        actual: Option<String>,
    },
    Fence {
        collection: String,
        key: String,
        expected: String,
        actual: String,
    },
}

Which predicate failed, and what the authority actually holds.

Structured rather than a formatted string, because the caller has to tell a lost race from a broken deployment: the first is retried with fresh state, the second is not retried at all.

Variants

Present

Required absent, but the record exists.

Fields

collection: String

key: String

Missing

A predicate was given for a record that does not exist.

Fields

collection: String

key: String

Version

Fields

collection: String

key: String

expected: u64

actual: u64

Epoch

Fields

collection: String

key: String

expected: u64

actual: u64

Lease

Fields

collection: String

key: String

expected: String

actual: Option<String>

Fence

State named by a read basis changed after the basis was read.

The tokens are kept for diagnostics inside the authority but never serialized: a refusal says that the basis changed, not what it digests.

Fields

collection: String

key: String

expected: String

actual: String

Implementations

impl PreconditionFailure

pub fn collection(&self) -> &str

pub fn key(&self) -> &str

The storage key, which is namespaced as collection:id.

impl PreconditionFailure

pub fn public_json(&self, layout: &ReadLayout) -> Value

The refusal as every transport serializes it: predicate, the application’s collection (never a storage namespace), the record id, its key as collection:id, and expected / actual where the predicate has them. A fence names the first fenced collection and key: "read-basis", with no id and no tokens.

layout is where the authority addressed the record: the direct route keys rows collection:id under collection; an application namespace keys them by id under namespace:collection.

Trait Implementations

impl Clone for PreconditionFailure

fn clone(&self) -> PreconditionFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreconditionFailure

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PreconditionFailure

fn deserialize<__D>( __deserializer: __D, ) -> Result<PreconditionFailure, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PreconditionFailure

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

Formats the value using the given formatter.

impl PartialEq for PreconditionFailure

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PreconditionFailure

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PreconditionFailure