Struct DriverDown

pub struct DriverDown;

error indicate Client’s Driver is dropped and can’t be accessed anymore when sending request to driver.

database query related to this error has not been sent to database and it’s safe to retry operation if desired.

Error source

detailed reason of driver shutdown can be obtained from output of Driver’s AsyncLendingIterator or IntoFuture trait impl method

Examples

// start a connection and spawn driver task
let (cli, drv) = Postgres::new("<db_confg>").connect().await?;
// keep the driver task's join handle for later use
let handle = tokio::spawn(drv.into_future());

// when query returns error immediately we check if the driver is gone.
if let Err(e) = "".query(&cli).await {
    if e.is_driver_down() {
        // driver is gone and we want to know detail reason in this case.
        // await on the join handle will return the output of Driver task.
        let opt = handle.await.unwrap();
        println!("{opt:?}");
    }
}

Trait Implementations

impl Debug for DriverDown

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

Formats the value using the given formatter.

impl Default for DriverDown

fn default() -> DriverDown

Returns the “default value” for a type.

impl Display for DriverDown

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

Formats the value using the given formatter.

impl Error for DriverDown

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<DriverDown> for Error

fn from(e: DriverDown) -> Self

Converts to this type from the input type.