Skip to main content

ConditionViolated

Struct ConditionViolated 

Source
#[non_exhaustive]
pub struct ConditionViolated { pub conflicting_position: Option<SequencePosition>, }
Expand description

The specification-defined outcome of an append that was rejected because the store already held an event matching the AppendCondition.

This is the DCB concurrency signal. Callers respond by rebuilding their decision model from the current state and retrying — it is an expected, routine outcome under contention, not a fault.

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§conflicting_position: Option<SequencePosition>

The position of a conflicting event, when the adapter can identify one cheaply.

A hint, not a promise, and a caller must be written for None. An adapter that detects the conflict without learning which event caused it reports None, and that is not a deficient adapter: a store reached over one-shot HTTP has no interactive transaction, so the only shape it can express is a conditional INSERT … SELECT … WHERE NOT EXISTS, which yields a boolean and no row. A retry loop that branches on this field being Some works against an in-process store and stops working against a remote one.

Implementations§

Source§

impl ConditionViolated

Source

pub const fn unspecified() -> Self

A violation with no identified conflicting event.

Source

pub const fn at(position: SequencePosition) -> Self

A violation naming the event that caused it.

Trait Implementations§

Source§

impl Clone for ConditionViolated

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ConditionViolated

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for ConditionViolated

Source§

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

Renders the conflicting position when the adapter supplied one.

Hand-written rather than a thiserror attribute because the message has two shapes, and the field the store already populates was previously carried and never shown — an operator reading a log got “the store already contains a matching event” and no way to find which.

Source§

impl Eq for ConditionViolated

Source§

impl Error for ConditionViolated

1.30.0 · Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type-based access to context intended for error reports. Read more
Source§

impl<E> From<ConditionViolated> for AppendError<E>

Source§

fn from(source: ConditionViolated) -> Self

Converts to this type from the input type.
Source§

impl PartialEq for ConditionViolated

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ConditionViolated

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.