pub struct ConnectorError { /* private fields */ }
Expand description

Error from the underlying Connector

Connector exists to attach a ConnectorErrorKind to what would otherwise be an opaque Box<dyn Error> that comes off a potentially generic or dynamic connector. The attached kind is used to determine what retry behavior should occur (if any) based on the connector error.

Implementations§

source§

impl ConnectorError

source

pub fn timeout(source: Box<dyn Error + Send + Sync>) -> ConnectorError

Construct a ConnectorError from an error caused by a timeout

Timeout errors are typically retried on a new connection.

source

pub fn with_connection(self, info: ConnectionMetadata) -> ConnectorError

Include connection information along with this error

source

pub fn never_connected(self) -> ConnectorError

Set the connection status on this error to report that a connection was never established

source

pub fn user(source: Box<dyn Error + Send + Sync>) -> ConnectorError

Construct a ConnectorError from an error caused by the user (e.g. invalid HTTP request)

source

pub fn io(source: Box<dyn Error + Send + Sync>) -> ConnectorError

Construct a ConnectorError from an IO related error (e.g. socket hangup)

source

pub fn other( source: Box<dyn Error + Send + Sync>, kind: Option<ErrorKind> ) -> ConnectorError

Construct a ConnectorError from an different unclassified error.

Optionally, an explicit Kind may be passed.

source

pub fn is_io(&self) -> bool

Returns true if the error is an IO error

source

pub fn is_timeout(&self) -> bool

Returns true if the error is an timeout error

source

pub fn is_user(&self) -> bool

Returns true if the error is a user-caused error (e.g., invalid HTTP request)

source

pub fn is_other(&self) -> bool

Returns true if the error is an unclassified error.

source

pub fn as_other(&self) -> Option<ErrorKind>

Returns the optional error kind associated with an unclassified error

source

pub fn into_source(self) -> Box<dyn Error + Send + Sync>

Grants ownership of this error’s source.

source

pub fn connection_metadata(&self) -> Option<&ConnectionMetadata>

Returns metadata about the connection

If a connection was established and provided by the internal connector, a connection will be returned.

Trait Implementations§

source§

impl Debug for ConnectorError

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for ConnectorError

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for ConnectorError

source§

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

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

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. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more