Enum ServeError

pub enum ServeError {
    MethodNotAllowed,
    InvalidPath,
    NotModified,
    PreconditionFailed,
    RangeNotSatisfied(u64),
    NotFound,
    Io(Error),
}

high level error types for serving file. see into_response_from and into_response for way of converting error to Response type.

Variants

MethodNotAllowed

request method is not allowed. only GET/HEAD methods are allowed.

InvalidPath

requested file path is invalid.

NotModified

requested file has not been modified.

PreconditionFailed

requested file has been modified before given precondition time.

RangeNotSatisfied(u64)

requested file range is not satisfied. u64 is the max range of file.

NotFound

can not find requested file.

Io(Error)

I/O error from file system.

Implementations

impl ServeError

pub fn into_response_from<Ext>(self, req: Request<Ext>) -> Response<()>

produce a response from error. an existing request is received for inherent it’s extension data and reuse it’s heap allocation.

Examples

#[derive(Clone)]
struct User;

let mut req = Request::new(());
req.extensions_mut().insert(User); // data type were inserted into request extension.

let mut res = ServeError::NotFound.into_response_from(req);

res.extensions_mut().remove::<User>().unwrap(); // data type is moved to response.

pub fn into_response(self) -> Response<()>

produce a response from error.

Trait Implementations

impl Debug for ServeError

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

Formats the value using the given formatter.

impl Display for ServeError

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

Formats the value using the given formatter.

impl Error for ServeError

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 ServeError

fn from(e: Error) -> Self

Converts to this type from the input type.