Enum HttpCacheError 

pub enum HttpCacheError {
    Client(Box<dyn Error + Send + Sync>),
    Cache(String),
    BadRequest(BadRequest),
    Http(Box<dyn Error + Send + Sync>),
    Body(Box<dyn Error + Send + Sync>),
    Streaming(StreamingError),
    Other(Box<dyn Error + Send + Sync>),
}

Unified error type for HTTP cache operations that works across all client libraries.

This enum consolidates error handling patterns from all http-cache client crates (reqwest, surf, tower, ureq) while providing a clean, extensible interface.

Examples

use http_cache::{HttpCacheError, BadRequest};

// Cache operation errors
let cache_err = HttpCacheError::cache("Failed to read cache entry");

// Request parsing errors
let request_err = HttpCacheError::from(BadRequest);

// HTTP processing errors
let http_err = HttpCacheError::http("Invalid header format");

// Body processing errors  
let body_err = HttpCacheError::body("Failed to collect request body");

Variants

Client(Box<dyn Error + Send + Sync>)

HTTP client error (reqwest, surf, etc.)

Cache(String)

HTTP cache operation failed

BadRequest(BadRequest)

Request parsing failed (e.g., non-cloneable request)

Http(Box<dyn Error + Send + Sync>)

HTTP processing error (header parsing, version handling, etc.)

Body(Box<dyn Error + Send + Sync>)

Body processing error (collection, streaming, etc.)

Streaming(StreamingError)

Streaming operation error (with detailed error kind)

Other(Box<dyn Error + Send + Sync>)

Other generic error

Implementations

impl HttpCacheError

pub fn cache<S>(message: S) -> HttpCacheError

where S: Into<String>,

Create a cache operation error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::cache("Cache entry not found");

pub fn http<E>(error: E) -> HttpCacheError

where E: Into<Box<dyn Error + Send + Sync>>,

Create an HTTP processing error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::http("Invalid header format");

pub fn body<E>(error: E) -> HttpCacheError

where E: Into<Box<dyn Error + Send + Sync>>,

Create a body processing error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::body("Failed to collect request body");

pub fn client<E>(error: E) -> HttpCacheError

where E: Into<Box<dyn Error + Send + Sync>>,

Create a client error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::client("Network timeout");

pub fn other<E>(error: E) -> HttpCacheError

where E: Into<Box<dyn Error + Send + Sync>>,

Create a generic error

Examples

use http_cache::HttpCacheError;

let err = HttpCacheError::other("Unexpected error occurred");

pub fn is_cache_error(&self) -> bool

Returns true if this error is related to cache operations

pub fn is_client_error(&self) -> bool

Returns true if this error is related to client operations

pub fn is_streaming_error(&self) -> bool

Returns true if this error is related to streaming operations

pub fn is_bad_request(&self) -> bool

Returns true if this error is a bad request

Trait Implementations

impl Debug for HttpCacheError

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

Formats the value using the given formatter.

impl Display for HttpCacheError

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

Formats the value using the given formatter.

impl Error for HttpCacheError

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<BadHeader> for HttpCacheError

fn from(error: BadHeader) -> HttpCacheError

Converts to this type from the input type.

impl From<BadRequest> for HttpCacheError

fn from(error: BadRequest) -> HttpCacheError

Converts to this type from the input type.

impl From<BadVersion> for HttpCacheError

fn from(error: BadVersion) -> HttpCacheError

Converts to this type from the input type.

impl From<Box<dyn Error + Send + Sync>> for HttpCacheError

fn from(error: Box<dyn Error + Send + Sync>) -> HttpCacheError

Converts to this type from the input type.

impl From<ClientStreamingError> for HttpCacheError

fn from(error: ClientStreamingError) -> HttpCacheError

Converts to this type from the input type.

impl From<Error> for HttpCacheError

fn from(error: Error) -> HttpCacheError

Converts to this type from the input type.

impl From<Error> for HttpCacheError

fn from(error: Error) -> HttpCacheError

Converts to this type from the input type.

impl From<InvalidHeaderName> for HttpCacheError

fn from(error: InvalidHeaderName) -> HttpCacheError

Converts to this type from the input type.

impl From<InvalidHeaderValue> for HttpCacheError

fn from(error: InvalidHeaderValue) -> HttpCacheError

Converts to this type from the input type.

impl From<InvalidMethod> for HttpCacheError

fn from(error: InvalidMethod) -> HttpCacheError

Converts to this type from the input type.

impl From<InvalidStatusCode> for HttpCacheError

fn from(error: InvalidStatusCode) -> HttpCacheError

Converts to this type from the input type.

impl From<InvalidUri> for HttpCacheError

fn from(error: InvalidUri) -> HttpCacheError

Converts to this type from the input type.

impl From<ParseError> for HttpCacheError

Available on crate feature url-standard only.

fn from(error: ParseError) -> HttpCacheError

Converts to this type from the input type.

impl From<StreamingError> for HttpCacheError

fn from(error: StreamingError) -> HttpCacheError

Converts to this type from the input type.