Enum Error 

#[non_exhaustive]
pub enum Error {
    NotFound,
    MethodNotAllowed,
    BadRequest(String),
    Unauthorized,
    Forbidden,
    Internal(String),
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound

MethodNotAllowed

BadRequest(String)

Unauthorized

Forbidden

Internal(String)

Implementations

impl Error

pub fn status(&self) -> u16

HTTP status code associated with this variant.

Examples found in repository

examples/homepage.rs (line 33)

async fn logger(req: Request, next: Next) -> Result<Response, Error> {
    let method = req.method().clone();
    let path = req.uri().path().to_owned();
    let id = req.ctx().get::<RequestId>().map(|r| r.0);
    let user = rustio_core::auth::identity(req.ctx()).map(|i| i.user_id.clone());
    let started = Instant::now();
    let result = next.run(req).await;
    let status = match &result {
        Ok(resp) => resp.status().as_u16(),
        Err(err) => err.status(),
    };
    let id_display = id.map(|i| format!("req-{i}")).unwrap_or_else(|| "-".into());
    let user_display = user.unwrap_or_else(|| "-".into());
    eprintln!(
        "[{:>3}] {:>4} {} id={} user={} ({:?})",
        status,
        method,
        path,
        id_display,
        user_display,
        started.elapsed()
    );
    result
}

pub fn message(&self) -> &str

Human-readable message carried by the variant.

For Internal, this returns the full underlying detail. That detail is safe for logs but is not sent to HTTP clients — see Error::into_response.

pub fn into_response(self) -> Response

Convert this error into an HTTP response.

The body exposed to clients is sanitized for Internal — it always reads "Internal Server Error", never the original detail.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(value: Error) -> Self

Converts to this type from the input type.