Enum RestError 

pub enum RestError {
    Io(Error),
    Http(HttpError),
    BodyTooLarge {
        size: usize,
        max: usize,
    },
    RequestTooLarge {
        capacity: usize,
    },
    CrlfInjection,
    ConnectionPoisoned,
    ReadTimeout,
    ConnectionStale,
    ConnectionClosed(&'static str),
    InvalidUrl(String),
    TlsNotEnabled,
    Tls(TlsError),
}

REST client error.

Variants

Io(Error)

I/O error.

Http(HttpError)

HTTP protocol error.

BodyTooLarge

Response body exceeds max size.

Fields

size: usize

Size reported by Content-Length (or accumulated for chunked).

max: usize

Configured maximum body size in bytes.

RequestTooLarge

Request exceeds WriteBuf capacity.

Fields

capacity: usize

Capacity of the write buffer in bytes.

CrlfInjection

Header name/value or query parameter contains CR/LF bytes.

ConnectionPoisoned

Connection is poisoned after an I/O error mid-response.

ReadTimeout

Read timed out waiting for response.

ConnectionStale

Connection is stale (dead socket detected after timeout).

ConnectionClosed(&'static str)

Connection closed before response complete.

InvalidUrl(String)

Invalid URL.

TlsNotEnabled

https:// URL used without the tls feature enabled.

Tls(TlsError)

TLS error during connection setup (handshake, certificate validation, hostname resolution).

Steady-state TLS protocol errors (decrypt failure, peer alert, malformed record received during a request) on the async nexus-async-web paths surface as RestError::Io instead — the underlying TlsError is wrapped via io::Error::other and reachable via io_err.source() or io_err.get_ref(). This asymmetry stems from the WireStream trait returning io::Result for poll methods. Sync REST surfaces Tls directly because its TlsStream exposes TlsError natively. Pattern-match on both Io and Tls if you need to distinguish TLS-protocol failures from generic transport failures across both surfaces.

Trait Implementations

impl Debug for RestError

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

Formats the value using the given formatter.

impl Display for RestError

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

Formats the value using the given formatter.

impl Error for RestError

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

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<HttpError> for RestError

fn from(e: HttpError) -> Self

Converts to this type from the input type.

impl From<TlsError> for RestError

Available on crate feature tls only.

fn from(e: TlsError) -> Self

Converts to this type from the input type.