Enum RetrofitError 

pub enum RetrofitError {
    ConnectionError {
        url: String,
        message: String,
    },
    TimeoutError {
        method: String,
        url: String,
        duration: Duration,
    },
    DnsError {
        host: String,
        message: String,
    },
    TlsError {
        url: String,
        message: String,
    },
    HttpError {
        status: u16,
        reason: String,
        method: String,
        url: String,
        headers: Box<HashMap<String, String>>,
        body: Option<Box<String>>,
    },
    JsonError {
        context: String,
        message: String,
    },
    InvalidResponseFormat {
        expected: String,
        actual: String,
    },
    UrlParseError {
        url: String,
        message: String,
    },
    ConfigError(String),
    RequestBuildError {
        method: String,
        path: String,
        message: String,
    },
    TooManyRedirects {
        url: String,
        count: usize,
    },
    BodyReadError {
        url: String,
        message: String,
    },
    RequestError(String),
}

Retrofit error types with detailed context

Variants

ConnectionError

Connection failed (network unreachable, connection refused, etc.)

Fields

url: String

message: String

TimeoutError

Request timeout

Fields

method: String

url: String

duration: Duration

DnsError

DNS resolution failed

Fields

host: String

message: String

TlsError

TLS/SSL error

Fields

url: String

message: String

HttpError

HTTP status error with detailed context

Fields

status: u16

reason: String

method: String

url: String

headers: Box<HashMap<String, String>>

body: Option<Box<String>>

JsonError

JSON serialization/deserialization failed

Fields

context: String

message: String

InvalidResponseFormat

Invalid response format

Fields

expected: String

actual: String

UrlParseError

URL parsing/building failed

Fields

url: String

message: String

ConfigError(String)

Configuration error

RequestBuildError

Request building error

Fields

method: String

path: String

message: String

TooManyRedirects

Too many redirects

Fields

url: String

count: usize

BodyReadError

Body reading error

Fields

url: String

message: String

RequestError(String)

Generic request error (catch-all for reqwest errors)

Implementations

impl RetrofitError

pub fn connection_error( url: impl Into<String>, message: impl Into<String>, ) -> Self

Create a connection error

pub fn timeout_error( method: impl Into<String>, url: impl Into<String>, duration: Duration, ) -> Self

Create a timeout error

pub fn http_error( status: u16, method: impl Into<String>, url: impl Into<String>, body: Option<String>, ) -> Self

Create an HTTP error

pub fn http_error_with_headers( status: u16, method: impl Into<String>, url: impl Into<String>, headers: HashMap<String, String>, body: Option<String>, ) -> Self

Create an HTTP error with headers

pub fn is_timeout(&self) -> bool

Check if this is a timeout error

pub fn is_client_error(&self) -> bool

Check if this is a client error (4xx)

pub fn is_server_error(&self) -> bool

Check if this is a server error (5xx)

pub fn is_retryable(&self) -> bool

Check if error is retryable

pub fn url(&self) -> Option<&str>

Get the URL associated with this error, if any

Trait Implementations

impl Debug for RetrofitError

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

Formats the value using the given formatter.

impl Display for RetrofitError

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

Formats the value using the given formatter.

impl Error for RetrofitError

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 RetrofitError

Convert from reqwest::Error with context

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RetrofitError

Convert from serde_json::Error with context

fn from(err: Error) -> Self

Converts to this type from the input type.