Struct tc_error::TCError

pub struct TCError { /* private fields */ }

A general error description.

Implementations

impl TCError

pub fn new<I: Display>(code: ErrorType, message: I) -> Self

Returns a new error with the given code and message.

pub fn with_stack<I, S, SI>(code: ErrorType, message: I, stack: S) -> Selfwhere
    I: Display,
    SI: Display,
    S: IntoIterator<Item = SI>,

Reconstruct a TCError from its ErrorType and data.

pub fn bad_gateway<I: Display>(cause: I) -> Self

Error indicating that the an upstream server send an invalid response.

pub fn bad_request<M: Display, I: Display>(message: M, cause: I) -> Self

Error indicating that the request is badly-constructed or nonsensical.

pub fn conflict<M: Display>(message: M) -> Self

Error indicating that the request depends on a resource which is exclusively locked by another request.

pub fn forbidden<M: Display, I: Display>(message: M, id: I) -> Self

Error indicating that the request actor’s credentials do not authorize access to some request dependencies.

pub fn internal<I: Display>(info: I) -> Self

A truly unexpected error, for which the calling application cannot define any specific handling behavior.

pub fn method_not_allowed<M: Display, S: Display, P: Display>(
    method: M,
    subject: S,
    path: P
) -> Self

Error indicating that the requested resource exists but does not support the request method.

pub fn not_found<I: Display>(locator: I) -> Self

Error indicating that the requested resource does not exist at the specified location.

pub fn not_implemented<F: Display>(feature: F) -> Self

Error indicating that a required feature is not yet implemented.

pub fn timeout<I: Display>(info: I) -> Self

Error indicating that the request failed to complete in the allotted time.

pub fn unauthorized<I: Display>(info: I) -> Self

Error indicating that the user’s credentials are missing or nonsensical.

pub fn unavailable<I: Display>(info: I) -> Self

Error indicating that this host is currently overloaded

pub fn unsupported<I: Display>(info: I) -> Self

Error indicating that the request is badly-constructed or nonsensical.

pub fn code(&self) -> ErrorType

pub fn message(&self) -> &str

pub fn consume<I: Display>(self, info: I) -> Self

Trait Implementations

impl Debug for TCError

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

Formats the value using the given formatter.

impl Display for TCError

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

Formats the value using the given formatter.

impl Error for TCError

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

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, demand: &mut Demand<'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 TCError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Infallible> for TCError

fn from(_: Infallible) -> Self

Converts to this type from the input type.

impl<'en> IntoStream<'en> for TCError

fn into_stream<E: Encoder<'en>>(self, encoder: E) -> Result<E::Ok, E::Error>

Take ownership of this value and serialize it into the given encoder.

impl<'en> ToStream<'en> for TCError

fn to_stream<E: Encoder<'en>>(&'en self, encoder: E) -> Result<E::Ok, E::Error>

Serialize this value into the given encoder.