Enum DbError 

#[non_exhaustive]
pub enum DbError {
    ConnectionFailed {
        url: String,
        message: String,
    },
    QueryFailed {
        table: &'static str,
        operation: &'static str,
        message: String,
    },
    ConstraintViolation {
        table: &'static str,
        constraint: String,
        message: String,
    },
    MigrationFailed {
        version: i32,
        message: String,
    },
    TransactionFailed {
        message: String,
    },
    PoolExhausted {
        timeout_ms: u64,
    },
    SerializationError {
        field: String,
        message: String,
    },
    Other(String),
}

Specific database error types with context.

This enum provides detailed, typed database errors that preserve context about what operation failed and why. Use CommerceError::as_db_error() to extract the underlying database error for detailed handling.

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.

ConnectionFailed

Failed to establish database connection.

Fields

url: String

The database URL or connection string.

message: String

Detailed error message.

QueryFailed

Query execution failed.

Fields

table: &'static str

The table being queried.

operation: &'static str

The operation (e.g., “insert”, “update”, “select”).

message: String

Detailed error message.

ConstraintViolation

Constraint violation (unique, foreign key, check).

Fields

table: &'static str

The table with the constraint.

constraint: String

The constraint name or type.

message: String

Detailed error message.

MigrationFailed

Database migration failed.

Fields

version: i32

The migration version that failed.

message: String

Detailed error message.

TransactionFailed

Transaction error.

Fields

message: String

Detailed error message.

PoolExhausted

Connection pool exhausted.

Fields

timeout_ms: u64

The timeout in milliseconds before giving up.

SerializationError

Serialization/deserialization error.

Fields

field: String

The field being serialized/deserialized.

message: String

Detailed error message.

Other(String)

Generic database error (fallback).

Implementations

impl DbError

pub fn query_failed( table: &'static str, operation: &'static str, message: impl Into<String>, ) -> Self

Create a query failed error.

pub fn constraint_violation( table: &'static str, constraint: impl Into<String>, message: impl Into<String>, ) -> Self

Create a constraint violation error.

pub fn connection_failed( url: impl Into<String>, message: impl Into<String>, ) -> Self

Create a connection failed error.

pub fn transaction_failed(message: impl Into<String>) -> Self

Create a transaction failed error.

pub fn serialization_error( field: impl Into<String>, message: impl Into<String>, ) -> Self

Create a serialization error.

Trait Implementations

impl Clone for DbError

fn clone(&self) -> DbError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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 #99301)

Provides type-based access to context intended for error reports.

impl From<DbError> for CommerceError

fn from(source: DbError) -> Self

Converts to this type from the input type.