Trait HttpError 

pub trait HttpError:
    Error
    + Send
    + Sync
    + 'static {
    // Provided method
    fn status(&self) -> StatusCode { ... }
}

Trait for errors that have an associated HTTP status code.

This trait extends the standard Error trait to include a method for retrieving the HTTP status code associated with the error.

Provided Methods

fn status(&self) -> StatusCode

Returns the HTTP status code associated with this error.

Examples

use http_kit::{HttpError,StatusCode};
use thiserror::Error;

#[derive(Debug, Error)]
#[error("My error occurred")]
struct MyError;

impl HttpError for MyError {
    fn status(&self) -> StatusCode {
        StatusCode::INTERNAL_SERVER_ERROR
    }
}
let err = MyError;
assert_eq!(err.status(), StatusCode::INTERNAL_SERVER_ERROR);
assert_eq!(err.to_string(), "My error occurred");

Alternatively, you can use the http_error! macro to build zero-sized types that already implement HttpError with a fixed status code:

use http_kit::{http_error, StatusCode, HttpError};

http_error!(pub BadGateway, StatusCode::BAD_GATEWAY, "upstream failed");
let err = BadGateway::new();
assert_eq!(err.status(), StatusCode::BAD_GATEWAY);

Trait Implementations

impl Error for Box<dyn HttpError>

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 HttpError for Box<dyn HttpError>

fn status(&self) -> StatusCode

Returns the HTTP status code associated with this error.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl HttpError for !

fn status(&self) -> StatusCode

impl HttpError for Box<dyn HttpError>

fn status(&self) -> StatusCode

Implementors

impl HttpError for CacheError

impl HttpError for CookieError

impl HttpError for Error

impl HttpError for TimeoutError

impl HttpError for WebSocketError

impl<A, B> HttpError for MiddlewareTupleError<A, B>

where A: HttpError, B: HttpError,

impl<H: HttpError> HttpError for FollowRedirectError<H>

impl<H: HttpError> HttpError for OAuth2Error<H>

impl<N, E> HttpError for MiddlewareError<N, E>

where N: HttpError, E: HttpError,