Enum StorageError 

pub enum StorageError {
    Connection {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Serialization {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Deserialization {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    JobNotFound {
        job_id: String,
    },
    Timeout {
        timeout_ms: u64,
    },
    Unavailable {
        reason: String,
    },
    Configuration {
        message: String,
    },
    OperationFailed {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    CapacityExceeded {
        message: String,
    },
    ConcurrentModification {
        job_id: String,
    },
    MigrationError {
        message: String,
    },
    InvalidJobData {
        message: String,
    },
}

Storage-specific errors that can occur during job persistence operations.

Every variant that wraps an underlying driver error carries a source: Option<Box<dyn Error + Send + Sync>> field with #[source], so callers can walk Error::source() or downcast to the concrete type. Earlier revisions stringified the cause into message and dropped the chain; the helper constructors here always preserve it.

Variants

Connection

Connection-related errors (network, authentication, etc.)

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Serialization

Encoding a value (job, state, metadata) into the storage’s transport format failed.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

Deserialization

Decoding a value out of the storage’s transport format failed. Distinct from [Serialization] so callers handling a corrupt-row recovery path can match precisely.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

JobNotFound

Job not found in storage

Fields

job_id: String

Timeout

Storage operation timed out

Fields

timeout_ms: u64

Unavailable

Storage is unavailable or down

Fields

reason: String

Configuration

Configuration errors

Fields

message: String

OperationFailed

A storage-engine operation failed for a reason that isn’t a connection / serialization / not-found / capacity issue. The message field should already include enough operation context (e.g. "Failed to fetch and lock job"); the underlying driver error is preserved on source.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync>>

CapacityExceeded

Storage capacity exceeded

Fields

message: String

ConcurrentModification

Concurrent modification detected

Fields

job_id: String

MigrationError

Database migration errors

Fields

message: String

InvalidJobData

Invalid job data format

Fields

message: String

Implementations

impl StorageError

pub fn connection<S: Into<String>>(message: S) -> Self

Create a connection error with a message

pub fn connection_with_source<S: Into<String>>( message: S, source: Box<dyn Error + Send + Sync>, ) -> Self

Create a connection error with a message and source error

pub fn serialization<S: Into<String>>(message: S) -> Self

Create a serialization error with a message

pub fn serialization_with_source<S: Into<String>>( message: S, source: Box<dyn Error + Send + Sync>, ) -> Self

Create a serialization error with a message and source error

pub fn deserialization<S: Into<String>>(message: S) -> Self

Create a deserialization error with a message

pub fn deserialization_with_source<S: Into<String>>( message: S, source: Box<dyn Error + Send + Sync>, ) -> Self

Create a deserialization error with a message and source error

pub fn job_not_found<S: Into<String>>(job_id: S) -> Self

Create a job not found error

pub fn timeout(timeout_ms: u64) -> Self

Create a timeout error

pub fn unavailable<S: Into<String>>(reason: S) -> Self

Create an unavailable error

pub fn configuration<S: Into<String>>(message: S) -> Self

Create a configuration error

pub fn operation_failed<S: Into<String>>(message: S) -> Self

Create an operation-failed error without a source (e.g. when the failure is logical, not driven by an underlying driver error).

pub fn operation_failed_with_source<S: Into<String>>( message: S, source: Box<dyn Error + Send + Sync>, ) -> Self

Create an operation-failed error with a captured source.

pub fn capacity_exceeded<S: Into<String>>(message: S) -> Self

Create a capacity exceeded error

pub fn concurrent_modification<S: Into<String>>(job_id: S) -> Self

Create a concurrent modification error

pub fn conn_err<M, E>(message: M, source: E) -> Self

where M: Into<String>, E: Error + Send + Sync + 'static,

Connection shorthand that takes the raw error as a typed generic, boxes it, and attaches it as the source — saves the caller a Box::new(...).

pub fn ser_err<M, E>(message: M, source: E) -> Self

where M: Into<String>, E: Error + Send + Sync + 'static,

Serialization shorthand with a captured source.

pub fn de_err<M, E>(message: M, source: E) -> Self

where M: Into<String>, E: Error + Send + Sync + 'static,

Deserialization shorthand with a captured source.

pub fn op_err<M, E>(message: M, source: E) -> Self

where M: Into<String>, E: Error + Send + Sync + 'static,

OperationFailed shorthand with a captured source.

Trait Implementations

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

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<StorageError> for DatabaseInitError

fn from(source: StorageError) -> Self

Converts to this type from the input type.

impl From<StorageError> for QmlError

fn from(err: StorageError) -> Self

Converts to this type from the input type.