Struct InternalError 

pub struct InternalError<T> { /* private fields */ }

Helper type that can wrap any error and generate custom response.

InternalError renders the wrapped error with a fixed status code, or with a prepared response, and implements WebResponseError for every error domain. The Error* helpers in this module, such as ErrorBadRequest, create InternalError values.

In the following example an io::Error is rendered as 400 Bad Request instead of the default 500 Internal Server Error.

use ntex::http::StatusCode;
use ntex::web::{self, InternalError};

async fn index() -> Result<&'static str, InternalError<std::io::Error>> {
    let err = std::io::Error::other("error");
    Err(InternalError::new(err, StatusCode::BAD_REQUEST))
}

let app = web::App::default().route("/", web::get().to(index));

Implementations

impl<T> InternalError<T>

pub fn default(cause: T, status: StatusCode) -> Self

Create InternalError instance

impl<T> InternalError<T>

pub fn new(cause: T, status: StatusCode) -> Self

Create InternalError instance

pub fn from_response(cause: T, response: HttpResponse) -> Self

Create InternalError with predefined Response.

Trait Implementations

impl<T> Debug for InternalError<T>

where T: Debug + 'static,

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

Formats the value using the given formatter.

impl<T> Display for InternalError<T>

where T: Display + 'static,

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

Formats the value using the given formatter.

impl<T: Display + Debug + 'static> Error for InternalError<T>

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<St, T> Responder<St> for InternalError<T>

where St: State, T: Debug + Display + 'static,

async fn respond_to(self, st: &St, _: &HttpRequest) -> Response

Builds an HTTP response from this value.

fn with_status(self, status: StatusCode) -> CustomResponder<Self, St>

where Self: Sized,

Replaces the status code produced by this responder.

fn with_header<K, V>(self, key: K, value: V) -> CustomResponder<Self, St>

where Self: Sized, HeaderName: TryFrom<K>, HeaderValue: TryFrom<V>, <HeaderName as TryFrom<K>>::Error: Into<HttpError>, <HeaderValue as TryFrom<V>>::Error: Into<HttpError>,

Sets a header on the response produced by this responder.

impl<T> ResponseError for InternalError<T>

where T: Debug + Display + 'static,

fn error_response(&self) -> HttpResponse

Creates an HTTP response for this error.

impl<St, Err, T> WebResponseError<St, Err> for InternalError<T>

where T: Debug + Display + 'static,

fn error_response(&self, _: &St) -> HttpResponse

Generate response for error

fn into(self) -> Box<dyn WebResponseError<St, Err>>

where Self: Sized,

Convert the error into a boxed trait object.