Struct TransportFailure 

pub struct TransportFailure<E> { /* private fields */ }

Payload-redacting transport failure with an explicit delivery phase and optional already-observed final status.

Unknown send state must use Self::unknown, which conservatively maps to DeliveryPhase::PossiblySent.

Implementations

impl<E> TransportFailure<E>

pub const fn not_sent(error: E) -> Self

Records a failure proven to have happened before request delivery.

pub const fn possibly_sent(error: E) -> Self

Records a failure after request delivery may have begun.

pub const fn response_started(error: E) -> Self

Records a failure after any response head was observed.

pub const fn response_started_with_status(status: StatusCode, error: E) -> Self

Records a failure after the supplied final response status was observed.

pub const fn unknown(error: E) -> Self

Conservatively records an error whose delivery state is unknown.

pub const fn phase(&self) -> DeliveryPhase

Returns the conservative delivery phase.

pub const fn observed_status(&self) -> Option<StatusCode>

Returns a final status observed before response processing failed.

pub const fn with_observed_status(self, status: StatusCode) -> Self

Preserves this failure while attaching a subsequently known final status.

pub const fn error(&self) -> &E

Returns a shared view of the payload-free adapter error.

pub fn into_error(self) -> E

Consumes the failure and returns its adapter error.

pub fn map<F>(self, transform: impl FnOnce(E) -> F) -> TransportFailure<F>

Transforms the payload-free adapter error while preserving delivery state.

Trait Implementations

impl<E: Clone> Clone for TransportFailure<E>

fn clone(&self) -> TransportFailure<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Copy> Copy for TransportFailure<E>

impl<E> Debug for TransportFailure<E>

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

Formats the value using the given formatter.

impl<E> DeliveryClassified for TransportFailure<E>

fn delivery_phase(&self) -> DeliveryPhase

Returns the conservative delivery phase for permit transitions.

fn observed_status(&self) -> Option<StatusCode>

Returns a valid final status observed before the failure, when known.

impl<E> Display for TransportFailure<E>

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

Formats the value using the given formatter.

impl<E: Eq> Eq for TransportFailure<E>

impl<E> Error for TransportFailure<E>

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<E: PartialEq> PartialEq for TransportFailure<E>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.