Struct BodyPart 

pub struct BodyPart { /* private fields */ }

A single part of a multipart/form-data body.

A part carries the form field name declared by its Content-Disposition header, the file name of an uploaded file when the part is a file, the headers that belong to the part alone, and its raw content.

Storage is pub(super) (§17.14): a caller never touches the fields directly. The public read surface is the try_get_* family below, which follows the same Option-returning convention as crate::Request and crate::Response and therefore never fails loudly on a part that lacks an optional attribute.

Implementations

impl BodyPart

pub fn try_get_name(&self) -> Option<&String>

Tries to get the form field name of this part.

Returns

• Option<&BodyPartName> - The declared field name, or None when the part declares none.

pub fn try_get_file_name(&self) -> Option<&String>

Tries to get the uploaded file name of this part.

Returns

• Option<&BodyPartFileName> - The declared file name, or None when this part is a plain field rather than a file upload.

pub fn try_get_content_type(&self) -> Option<&String>

Tries to get the media type declared by this part.

Returns

• Option<&BodyPartContentType> - The declared media type, or None when the part declares none.

pub fn try_get_header<K>(&self, key: K) -> Option<&String>

where K: AsRef<str>,

Tries to get the value of one of this part’s headers.

Arguments

• K - The header name, which must implement AsRef<str>.

Returns

• Option<&BodyPartHeaderValue> - The header value, or None when this part carries no such header.

pub fn try_get_data(&self) -> Option<&[u8]>

Tries to get this part’s raw content.

Returns

• Option<&[u8]> - The raw bytes, or None when the part is empty.

pub fn try_get_text(&self) -> Option<String>

Tries to get this part’s raw content as UTF-8 text.

Invalid UTF-8 is replaced rather than rejected, so a binary upload read as text yields its readable bytes instead of None.

Returns

• Option<BodyFormValue> - The decoded text, or None when the part is empty.

impl BodyPart

pub fn new( name: String, file_name: String, content_type: String, headers: HashMap<String, String, BuildHasherDefault<Hasher>>, data: Vec<u8>, ) -> BodyPart

Trait Implementations

impl Clone for BodyPart

fn clone(&self) -> BodyPart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BodyPart

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

Formats the value using the given formatter.

impl Default for BodyPart

fn default() -> BodyPart

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BodyPart

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BodyPart

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

Formats the value using the standard debug format.

Arguments

• &mut std::fmt::Formatter<'_> - The formatter to write the representation into.

Returns

• std::fmt::Result - Success or failure of the formatting operation.

impl Eq for BodyPart

impl PartialEq for BodyPart

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BodyPart

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 BodyPart