Enum MultipartError

#[non_exhaustive]
pub enum MultipartError {
    ContentTypeMissing,
    ContentTypeParse,
    ContentTypeIncompatible,
    BoundaryMissing,
    ContentDispositionMissing,
    ContentDispositionNameMissing,
    Nested,
    Incomplete,
    Parse(ParseError),
    Payload(PayloadError),
    NotConsumed,
    Field {
        name: String,
        source: Error,
    },
    DuplicateField(String),
    MissingField(String),
    UnknownField(String),
}

A set of errors that can occur during parsing multipart streams.

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.

ContentTypeMissing

Could not find Content-Type header.

ContentTypeParse

Could not parse Content-Type header.

ContentTypeIncompatible

Parsed Content-Type did not have “multipart” top-level media type.

Also raised when extracting a MultipartForm from a request that does not have the “multipart/form-data” media type.

BoundaryMissing

Multipart boundary is not found.

ContentDispositionMissing

Content-Disposition header was not found or not of disposition type “form-data” when parsing a “form-data” field.

As per RFC 7578 §4.2, a “multipart/form-data” field’s Content-Disposition header must always be present and have a disposition type of “form-data”.

ContentDispositionNameMissing

Content-Disposition name parameter was not found when parsing a “form-data” field.

As per RFC 7578 §4.2, a “multipart/form-data” field’s Content-Disposition header must always include a “name” parameter.

Nested

Nested multipart is not supported.

Incomplete

Multipart stream is incomplete.

Parse(ParseError)

Field parsing failed.

Payload(PayloadError)

HTTP payload error.

NotConsumed

Stream is not consumed.

Field

Form field handler raised error.

Fields

name: String

source: Error

DuplicateField(String)

Duplicate field found (for structure that opted-in to denying duplicate fields).

MissingField(String)

Required field is missing.

UnknownField(String)

Unknown field (for structure that opted-in to denying unknown fields).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<(String, Error)> for Error

fn from(original: (String, Error)) -> Error

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(original: ParseError) -> Error

Converts to this type from the input type.

impl From<PayloadError> for Error

fn from(original: PayloadError) -> Error

Converts to this type from the input type.

impl ResponseError for Error

Return BadRequest for MultipartError.

fn status_code(&self) -> StatusCode

Returns appropriate status code for error.

fn error_response(&self) -> HttpResponse

Creates full response for error.