Enum Error 

#[non_exhaustive]
pub enum Error {
    Factory {
        message: String,
    },
    FactoryTimeout {
        elapsed: Duration,
    },
    LockTimeout {
        elapsed: Duration,
    },
    Serialization(String),
    Deserialization(String),
    Distributed(String),
    Backplane(String),
}

An error surfaced from a cache operation.

Note what is deliberately absent: a “cache miss” is not an error (it is a None/MaybeValue::none), and a factory that fails while fail-safe rescues a stale value never produces an Error at all.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Factory

The factory failed and no stale value or fail-safe default was available to fall back to. Carries the message reported by the factory.

Fields

message: String

The failure message reported by the factory.

FactoryTimeout

The factory exceeded its hard timeout and no fallback value existed.

Fields

elapsed: Duration

How long the factory was allowed to run before timing out.

LockTimeout

Acquiring the per-key single-flight lock exceeded its timeout and no fallback value existed.

Fields

elapsed: Duration

How long the caller waited for the lock.

Serialization(String)

A value could not be serialized for the distributed (L2) cache.

Deserialization(String)

A value could not be deserialized from the distributed (L2) cache.

Distributed(String)

The distributed (L2) cache backend returned an error.

Backplane(String)

The backplane backend returned an error.

Trait Implementations

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, __formatter: &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<FactoryError> for Error

fn from(err: FactoryError) -> Self

Converts to this type from the input type.