Enum RuntimeError 

#[non_exhaustive]
pub enum RuntimeError {
    Serialization(Error),
    InternalFailure(Error),
    NotAcceptable,
    UnsupportedMediaType,
    Validation(String),
}

A protocol-independent extractor rejection framed by the selected schema protocol.

Use this error with impl<P> FromParts<P> extractors on single-protocol or multi-protocol services. Schema upgrades call [IntoResponse::into_response_with_protocol], which delegates to crate::schema::ServerProtocol::serialize_runtime_error. Existing protocol-specific runtime-error types and their conversions remain available for explicitly static framing.

A direct [IntoResponse::into_response] call has no selected protocol: it returns an empty response with the semantic status and a RuntimeErrorExtension, without protocol headers. Supply a protocol to the context-aware method when direct conversion needs protocol framing.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Serialization(Error)

Request deserialization or response serialization failed.

InternalFailure(Error)

Internal framework or service state required by an extractor is unavailable.

NotAcceptable

The request’s Accept header cannot accept the response content type.

UnsupportedMediaType

The request’s Content-Type does not match the expected content type.

Validation(String)

An extractor rejected the request with a validation reason.

This is a runtime validation response, distinct from a modeled constraint violation. Each protocol frames the reason in its response format, or discards it where its existing runtime validation response omits the message. This variant does not carry a modeled error shape. Custom modeled validation errors retain their schema through crate::schema::DeserializeError::ConstraintViolation.

Implementations

impl RuntimeError

pub fn name(&self) -> &'static str

The error name used by protocol framing and RuntimeErrorExtension.

pub fn status_code(&self) -> StatusCode

The semantic status used when conversion has no selected protocol.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

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<InternalFailureException> for RuntimeError

fn from(_: InternalFailureException) -> Self

Converts to this type from the input type.