Enum PoolError 

pub enum PoolError {
    Config(String),
    Closed(String),
    Timeout(String),
    Exhausted(String),
    ConnectionCreate {
        message: String,
        source: Option<FactoryError>,
    },
    CircuitOpen {
        retry_after: f64,
    },
    InvalidRelease(String),
}

Every error the pool raises. Mirrors the PoolError base type of the other languages; each variant corresponds to a sibling error class.

Variants

Config(String)

Invalid pool / breaker / retry configuration (PoolConfigError).

Closed(String)

The pool has been closed; no more connections can be acquired (PoolClosedError).

Timeout(String)

No connection became available before the acquire deadline (PoolTimeoutError).

Exhausted(String)

The pool is full and the waiter queue is at max_waiters (PoolExhaustedError).

ConnectionCreate

The factory failed to create a connection after all retries (ConnectionCreateError). The original error is available via Error::source/PoolError::source_error.

Fields

message: String

Human-readable message.

source: Option<FactoryError>

The underlying factory error, if any.

CircuitOpen

The circuit breaker is rejecting calls to protect a failing backend (CircuitOpenError). retry_after is the approximate seconds until it probes again.

Fields

retry_after: f64

Approximate seconds until the breaker probes again.

InvalidRelease(String)

An object that is not checked out from this pool was released — a double release? (InvalidReleaseError).

Implementations

impl PoolError

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

Returns the underlying factory error for a PoolError::ConnectionCreate, if present.

Trait Implementations

impl Debug for PoolError

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

Formats the value using the given formatter.

impl Display for PoolError

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

Formats the value using the given formatter.

impl Error for PoolError

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.