Enum Error 

pub enum Error {
    Source(SharedError),
    FallbackTimeout(Arc<FallbackTimeout>),
    Panic(Arc<str>),
    Config(ConfigError),
    MissingRemote,
    Remote(SharedError),
}

Every failure a cached call or maintenance operation can report.

Cache plumbing fails open, so a call fails only when its source fails, its source deadline elapses, a callback panics, or static configuration is rejected before execution. Maintenance operations surface their own remote failures.

Variants

Source(SharedError)

The source returned an error. Every coalesced caller receives the same shared error, so identity comparisons through Arc::ptr_eq work.

FallbackTimeout(Arc<FallbackTimeout>)

The source did not settle before its deadline. Followers of one execution share the leader’s error instance.

Panic(Arc<str>)

A source, codec, provider or comparator panicked.

Config(ConfigError)

Static operation or instance configuration was rejected before execution.

MissingRemote

Invalidation was requested without a configured remote adapter.

Remote(SharedError)

An explicit maintenance mutation failed at the remote adapter.

Implementations

impl Error

pub fn source_error(&self) -> Option<&(dyn Error + Send + Sync + 'static)>

The source error, when the source itself failed.

pub fn is_fallback_timeout(&self) -> bool

Whether this is a source deadline error: the library’s own, or one a source propagated from a nested cached call, either as the bare FallbackTimeout or boxed inside a nested Error.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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.

impl From<ConfigError> for Error

fn from(error: ConfigError) -> Self

Converts to this type from the input type.