Struct HandlerError 

pub struct HandlerError { /* private fields */ }

Error returned from a route handler.

See the module-level docs for the full design rationale.

Implementations

impl HandlerError

pub fn new(status: StatusCode) -> Self

Create a HandlerError with the given status and no source/message.

pub fn internal(message: impl Into<String>) -> Self

Create a 500 Internal Server Error with a human-readable message.

pub const fn with_status(self, status: StatusCode) -> Self

Override the ICAP status emitted to the client.

pub fn with_message(self, message: impl Into<String>) -> Self

Attach a human-readable message used as the response reason phrase.

pub fn with_source(self, source: impl Into<BoxError>) -> Self

Attach an underlying error as the source (preserved in the error chain for logging).

pub const fn status(&self) -> StatusCode

The status code the server will send.

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

The configured message, if any.

pub fn source(&self) -> Option<&(dyn Error + 'static)>

The underlying source error, if any.

Trait Implementations

impl Debug for HandlerError

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

Formats the value using the given formatter.

impl Display for HandlerError

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

Formats the value using the given formatter.

impl<E> From<E> for HandlerError

where E: Error + Send + Sync + 'static,

fn from(err: E) -> Self

Converts to this type from the input type.