Struct roa::Error

pub struct Error {
    pub status_code: StatusCode,
    pub kind: ErrorKind,
    pub message: String,
    pub expose: bool,
}

The Error of roa.

Fields

status_code: StatusCode

StatusCode will be responded to client if Error is thrown by the top middleware.

Range

1xx/3xx/4xx/5xx

Example

use roa_core::{App, Context, Next, Result, MiddlewareExt, throw};
use roa_core::http::StatusCode;

let app = App::new(()).gate(gate).end(end);
async fn gate(ctx: &mut Context<()>, next: Next<'_>) -> Result {
    ctx.resp.status = StatusCode::OK;
    next.await // not caught
}

async fn end(ctx: &mut Context<()>) -> Result {
    throw!(StatusCode::IM_A_TEAPOT, "I'm a teapot!"); // throw
    unreachable!()
}

kind: ErrorKind

Error kind, is inferred automatically by status code.

message: String

Data will be written to response body if self.expose is true. StatusCode will be responded to client if Error is thrown by the top middleware.

Example

use roa_core::{App, Context, Result, Error};
use roa_core::http::StatusCode;

let app = App::new(()).end(end);

async fn end(ctx: &mut Context<()>) -> Result {
    Err(Error::new(StatusCode::IM_A_TEAPOT, "I'm a teapot!", false)) // message won't be exposed to user.
}

expose: bool

if message exposed.

Methods

impl Error

pub fn new(
    status_code: StatusCode,
    message: impl ToString,
    expose: bool
) -> Error

Construct an error.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<WrapError> for Error

fn from(err: WrapError) -> Error

Performs the conversion.