Struct ControllerError 

pub struct ControllerError {
    error_type: <ControllerError as BackendError>::ErrorType,
    message: String,
    source: Option<Error>,
    span_trace: Box<SpanTrace>,
    backtrace: Box<Backtrace>,
    location: Option<&'static Location<'static>>,
}

Represents error messages that are sent in responses. Used as the error type in ControllerError, which is used by all the controllers in the application.

All the information in the error is meant to be seen by the user. The type of error is determined by the ControllerErrorType enum, which is stored inside this struct. The type of the error determines which HTTP status code will be sent to the user.

Examples

Usage without source error

if erroneous_condition {
    return Err(ControllerError::new(
        ControllerErrorType::BadRequest,
        "Cannot create a new account when signed in.".to_string(),
        None,
    ));
}

Usage with a source error

Used when calling a function that returns an error that cannot be automatically converted to an ControllerError. (See impl From<X> implementations on this struct.)

some_function_returning_an_error().map_err(|original_error| {
    ControllerError::new(
        ControllerErrorType::InternalServerError,
        "Could not read file".to_string(),
        Some(original_error.into()),
    )
})?;

Example HTTP response from an error

{
    "title": "Internal Server Error",
    "message": "pool timed out while waiting for an open connection",
    "source": "source of error"
}

Fields

error_type: <ControllerError as BackendError>::ErrorType

message: String

source: Option<Error>

Original error that caused this error.

span_trace: Box<SpanTrace>

A trace of tokio tracing spans, generated automatically when the error is generated.

backtrace: Box<Backtrace>

Stack trace, generated automatically when the error is created.

location: Option<&'static Location<'static>>

Source location where the error was raised.

Implementations

impl ControllerError

fn render_clean_error(&self, out: &mut dyn Write, color: ColorChoice) -> Result

pub fn clean_string(&self, color: ColorChoice) -> String

Render this error in the clean developer format.

impl ControllerError

fn error_type_and_message_key(&self) -> (&'static str, &'static str)

fn validation_issues(&self) -> Vec<ApiErrorIssue>

Derives issue-level validation details from known backend validation cases.

Trait Implementations

impl BackendError for ControllerError

type ErrorType = ControllerErrorType

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

fn error_type(&self) -> &Self::ErrorType

fn message(&self) -> &str

fn span_trace(&self) -> &SpanTrace

fn location(&self) -> Option<&'static Location<'static>>

Source location where the error was raised, if captured.

fn new_with_traces_and_location<M: Into<String>, S: Into<Option<Error>>>( error_type: Self::ErrorType, message: M, source_error: S, backtrace: Backtrace, span_trace: SpanTrace, location: Option<&'static Location<'static>>, ) -> Self

The one required constructor; the others delegate to it.

fn new<M, S>(error_type: Self::ErrorType, message: M, source_error: S) -> Self

where M: Into<String>, S: Into<Option<Error>>, Self: Sized,

Create an error, capturing the caller’s location, a backtrace and the span trace.

fn new_with_traces<M, S>( error_type: Self::ErrorType, message: M, source_error: S, backtrace: Backtrace, span_trace: SpanTrace, ) -> Self

where M: Into<String>, S: Into<Option<Error>>, Self: Sized,

Like new but with an explicit backtrace and span trace, e.g. to preserve a source error’s traces.

fn to_different_error<T>( self, new_error_type: <T as BackendError>::ErrorType, new_message: String, ) -> T

where T: BackendError, Self: Sized + 'static + Send,

impl Debug for ControllerError

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

Formats the value using the given formatter.

impl Display for ControllerError

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

Formats the value using the given formatter.

impl Error for ControllerError

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

Returns the lower-level source of this error, if any.

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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<ChatbotError> for ControllerError

fn from(err: ChatbotError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for ControllerError

fn from(err: DecodeError) -> Self

Converts to this type from the input type.

impl From<DpopError> for ControllerError

fn from(err: DpopError) -> Self

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> ControllerError

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> ControllerError

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> ControllerError

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> ControllerError

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for ControllerError

fn from(err: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<ModelError> for ControllerError

fn from(err: ModelError) -> Self

Converts to this type from the input type.

impl From<Error> for ControllerError

fn from(err: MultipartError) -> Self

Converts to this type from the input type.

impl From<PkceError> for ControllerError

fn from(err: PkceError) -> Self

Converts to this type from the input type.

impl From<PkceFlowError> for ControllerError

fn from(err: PkceFlowError) -> Self

Converts to this type from the input type.

impl From<TokenGrantError> for ControllerError

fn from(err: TokenGrantError) -> Self

Converts to this type from the input type.

impl From<UtilError> for ControllerError

fn from(err: UtilError) -> Self

Converts to this type from the input type.

impl ResponseError for ControllerError

fn error_response(&self) -> HttpResponse

Creates full response for error.

fn status_code(&self) -> StatusCode

Returns appropriate status code for error.