Struct TransportError 

pub struct TransportError {
    pub Code: TransportErrorCode,
    pub Message: String,
    pub Source: Option<Box<dyn Error + Send + Sync>>,
    pub TransportKind: String,
    pub Method: Option<String>,
    pub CorrelationIdentifier: Option<String>,
    pub RetryAttempt: u32,
    pub Context: HashMap<String, String>,
}

Unified transport error.

Fields

Code: TransportErrorCode

Error code indicating the type of failure.

Message: String

Human-readable error message.

Source: Option<Box<dyn Error + Send + Sync>>

Optional underlying/boxed error.

TransportKind: String

The transport type that generated this error.

Method: Option<String>

The method being invoked when the error occurred (if applicable).

CorrelationIdentifier: Option<String>

The correlation/request ID for tracing.

RetryAttempt: u32

Number of retry attempts before this failure.

Context: HashMap<String, String>

Additional error context as key-value pairs.

Implementations

impl TransportError

pub fn New(Code: TransportErrorCode, Message: impl Into<String>) -> Self

Creates a new TransportError with the given code and message.

pub fn WithTransportKind(self, TransportKind: &str) -> Self

Sets the transport type on this error.

pub fn WithMethod(self, Method: &str) -> Self

Sets the method name on this error.

pub fn WithCorrelationIdentifier(self, CorrelationIdentifier: &str) -> Self

Sets the correlation/request ID on this error.

pub fn WithRetryAttempt(self, RetryAttempt: u32) -> Self

Sets the retry attempt count.

pub fn WithContext(self, Key: &str, Value: &str) -> Self

Adds a context key-value pair to this error.

pub fn WithSource(self, SourceError: impl Error + Send + Sync + 'static) -> Self

Sets the underlying source error.

pub fn IsRetryable(&self) -> bool

Returns true if this error is retryable.

pub fn RetryDelayMilliseconds(&self) -> u64

Returns the recommended retry delay in milliseconds.

pub fn FullMessage(&self) -> String

Returns the full error message with all context included.

impl TransportError

Convenience constructors for common transport errors.

pub fn Connection(Message: impl Into<String>) -> Self

Connection error: failed to connect or lost connection.

pub fn Timeout(Message: impl Into<String>) -> Self

Timeout error: operation exceeded deadline.

pub fn InvalidRequest(Message: impl Into<String>) -> Self

Invalid request error: bad parameters or format.

pub fn NotSupported(Message: impl Into<String>) -> Self

Not supported error: feature not implemented by this transport.

pub fn Remote(Message: impl Into<String>) -> Self

Remote error: the remote endpoint returned an error.

pub fn Internal(Message: impl Into<String>) -> Self

Internal error: something went wrong inside the transport.

pub fn CircuitBreakerOpen() -> Self

Circuit breaker open error: request rejected due to circuit breaker.

pub fn RateLimited(RetryAfterMilliseconds: u64) -> Self

Rate limited error: too many requests.

pub fn MessageTooLarge(Size: usize, MaximumSize: usize) -> Self

Message too large error.

pub fn NotFound(Message: impl Into<String>) -> Self

Not found error: resource or transport not found.

pub fn Serialization(Message: impl Into<String>) -> Self

Serialization error.

Trait Implementations

impl Clone for TransportError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransportError

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

Formats the value using the given formatter.

impl Display for TransportError

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

Formats the value using the given formatter.

impl Error for TransportError

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 PartialEq for TransportError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TransportError