Struct MultipartFormData 

pub struct MultipartFormData;

Parser for multipart/form-data bodies.

Decodes a body into its parts using the boundary declared by the request Content-Type header, without depending on any external multipart crate.

Implementations

impl MultipartFormData

Implementation for MultipartFormData.

pub fn get_boundary<C>(content_type: C) -> Option<String>

where C: AsRef<str>,

Reads the boundary parameter out of a multipart/form-data content type.

The parameter is matched case-insensitively and accepts both a quoted and a bare value, so the clients that emit boundary="abc" and the clients that emit boundary=abc are both accepted. A parameter that carries no = is skipped rather than aborting the scan.

Arguments

• C - The content type header value, which requires the AsRef<str> bound.

Returns

• Option<MultipartFormDataBoundary> - The declared boundary, or None when absent.

pub fn is_form_data<C>(content_type: C) -> bool

where C: AsRef<str>,

Checks whether a content type declares a multipart/form-data body.

Arguments

• C - The content type header value, which requires the AsRef<str> bound.

Returns

• bool - Whether the content type is multipart/form-data.

pub fn parse<B>(body: B, boundary: &str) -> Option<Vec<BodyPart>>

where B: AsRef<[u8]>,

Decodes every part of a multipart/form-data body.

A body that carries no declared boundary, a body whose final boundary is not the closing one, and a part that declares no name all yield None.

Arguments

• B - The raw request body, which requires the AsRef<[u8]> bound.
• &str - The declared boundary, without its leading dash pair.

Returns

• Option<MultipartFormDataParts> - The decoded parts, or None when malformed.

pub fn try_get_part<K>(parts: &[BodyPart], name: K) -> Option<&BodyPart>

where K: AsRef<str>,

Tries to get a part by its form field name.

Arguments

• &[BodyPart] - The decoded parts of the body.
• K - The form field name, which requires the AsRef<str> bound.

Returns

• Option<&BodyPart> - The first part carrying that name, or None.

pub fn try_get_part_text<K>(parts: &[BodyPart], name: K) -> Option<String>

where K: AsRef<str>,

Tries to get a plain text field by its form field name.

A part that uploads a file is skipped, so a file field never silently decodes as text.

Arguments

• &[BodyPart] - The decoded parts of the body.
• K - The form field name, which requires the AsRef<str> bound.

Returns

• Option<BodyFormValue> - The field value, or None when absent or a file.

pub fn parse_url_encoded<B>( body: B, ) -> HashMap<String, String, BuildHasherDefault<Hasher>>

where B: AsRef<[u8]>,

Decodes an application/x-www-form-urlencoded body into its fields.

Arguments

• B - The raw request body, which requires the AsRef<[u8]> bound.

Returns

• BodyForm - The decoded form fields.

Trait Implementations

impl Clone for MultipartFormData

fn clone(&self) -> MultipartFormData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for MultipartFormData

impl Debug for MultipartFormData

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

Formats the value using the given formatter.

impl Default for MultipartFormData

fn default() -> MultipartFormData

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MultipartFormData

fn deserialize<__D>( __deserializer: __D, ) -> Result<MultipartFormData, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MultipartFormData

impl PartialEq for MultipartFormData

fn eq(&self, other: &MultipartFormData) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for MultipartFormData

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MultipartFormData