Struct Error

pub struct Error { /* private fields */ }

The error type for HTTP operations.

Implementations

impl Error

pub fn new<S, E>(status: S, error: E) -> Self

where S: TryInto<StatusCode>, S::Error: Debug, E: Into<Error>,

Create a new error object from any error type.

The error type must be threadsafe and ’static, so that the Error will be as well. If the error type does not provide a backtrace, a backtrace will be created here to ensure that a backtrace exists.

pub fn from_str<S, M>(status: S, msg: M) -> Self

where S: TryInto<StatusCode>, S::Error: Debug, M: Display + Debug + Send + Sync + 'static,

Create a new error object from static string.

pub fn status(&self) -> StatusCode

Get the status code associated with this error.

pub fn set_status<S>(&mut self, status: S)

where S: TryInto<StatusCode>, S::Error: Debug,

Set the status code associated with this error.

pub const fn backtrace(&self) -> Option<BacktracePlaceholder>

pub fn into_inner(self) -> Error

Returns the inner anyhow::Error Note: This will lose status code information

pub fn downcast<E>(self) -> Result<E, Self>

where E: Display + Debug + Send + Sync + 'static,

Attempt to downcast the error object to a concrete type.

pub fn downcast_ref<E>(&self) -> Option<&E>

where E: Display + Debug + Send + Sync + 'static,

Downcast this error object by reference.

pub fn downcast_mut<E>(&mut self) -> Option<&mut E>

where E: Display + Debug + Send + Sync + 'static,

Downcast this error object by mutable reference.

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

Retrieves a reference to the type name of the error, if available.

pub fn from_display<D: Display>(error: D) -> Self

Converts anything which implements Display into an http_types::Error.

This is handy for errors which are not Send + Sync + 'static because std::error::Error requires Display. Note that any assiciated context not included in the Display output will be lost, and so this may be lossy for some types which implement std::error::Error.

Note: Prefer error.into() via From<Into<anyhow::Error>> when possible!

pub fn from_debug<D: Debug>(error: D) -> Self

Converts anything which implements Debug into an http_types::Error.

This is handy for errors which are not Send + Sync + 'static because std::error::Error requires Debug. Note that any assiciated context not included in the Debug output will be lost, and so this may be lossy for some types which implement std::error::Error.

Note: Prefer error.into() via From<Into<anyhow::Error>> when possible!

Trait Implementations

impl AsMut<StatusCode> for Error

fn as_mut(&mut self) -> &mut StatusCode

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Error> for Error

fn as_ref(&self) -> &Error

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<StatusCode> for Error

fn as_ref(&self) -> &StatusCode

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<dyn Error> for Error

fn as_ref(&self) -> &(dyn StdError + 'static)

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<dyn Error + Send + Sync> for Error

fn as_ref(&self) -> &(dyn StdError + Send + Sync + 'static)

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl<E: Into<Error>> From<E> for Error

fn from(error: E) -> Self

Converts to this type from the input type.

impl From<Error> for Box<dyn StdError + 'static>

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Box<dyn StdError + Send + Sync + 'static>

fn from(error: Error) -> Self

Converts to this type from the input type.