Enum DeserializeError 

#[non_exhaustive]
pub enum DeserializeError {
    Serde(SerdeError),
    InitialRequestFrame(String),
    BodyCollection(RequestBodyCollectionError<Error>),
    ConstraintViolation(Box<dyn HttpModeledError>),
    UnsupportedMediaType(Box<MissingContentTypeReason>),
    NotAcceptable,
    InternalFailure(Error),
}

Why a request failed without reaching its operation handler.

This is the one protocol-independent failure enum on the schema path: every way a request can fail before its handler runs lands here — almost always a failure to become the operation input, plus the missing-handler InternalFailure — and each protocol turns the whole enum into its wire response through ServerProtocol::serialize_rejection.

Variants preserve the failure category even when their rejection responses are identical. The Content-Type and Accept failures are not folded into Serde: protocols answer them differently (restJson1 keeps 415 and 406 distinct from the 400 that Serde produces), and the renderer matches on the variant to pick the response. They also originate in different layers: [SerdeError] belongs to the codec in aws-smithy-schema and describes failures reading the payload and bindings into the input shape, while the Content-Type and Accept checks run in the HTTP protocol layer before the codec — the codec never sees headers, and the transport-agnostic schema crate carries no HTTP semantics.

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.

Serde(SerdeError)

The request could not be read as the input shape: a malformed document, a type mismatch, an unparseable header, label or query value, or a request that could not be converted into its canonical form.

InitialRequestFrame(String)

Reading an RPC initial-request event frame failed. Preserve the generated serde raw validation rejection rather than treating a frame failure as a codec error.

BodyCollection(RequestBodyCollectionError<Error>)

Reading the request body failed, exceeded its size limit, or timed out. Preserves the typed failure while rendering the protocol’s ordinary deserialization rejection.

ConstraintViolation(Box<dyn HttpModeledError>)

The request was well-formed but violates a modeled constraint.

UnsupportedMediaType(Box<MissingContentTypeReason>)

The request’s Content-Type header does not match what the operation expects.

Raised by the protocol layer’s header check, never by the codec; carries the expected and found mime types the 415 response is built from.

NotAcceptable

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

Raised by the protocol layer’s header check, never by the codec.

InternalFailure(Error)

The service cannot run the selected operation.

Raised by the missing-handler fallback when a service built with build_unchecked receives a request for an operation without a registered handler, never by request parsing. Renders as the protocol’s 500 internal-failure response; the carried error is logged, not written to the wire.

Trait Implementations

impl Debug for DeserializeError

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

Formats the value using the given formatter.

impl Display for DeserializeError

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

Formats the value using the given formatter.

impl Error for DeserializeError

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<RequestBodyCollectionError<Error>> for DeserializeError

fn from(err: RequestBodyCollectionError<Error>) -> Self

Converts to this type from the input type.

impl From<SerdeError> for DeserializeError

fn from(err: SerdeError) -> Self

Converts to this type from the input type.