Struct multipart::client::lazy::Multipart

pub struct Multipart<'n, 'd> { /* fields omitted */ }

A multipart request which writes all fields at once upon being provided an output stream.

Sacrifices static dispatch for support for dynamic construction. Reusable.

Lifetimes

• 'n: Lifetime for field names; will only escape this struct in LazyIoError<'n>.
• 'd: Lifetime for data: will only escape this struct in PreparedFields<'d>.

Implementations

impl<'n, 'd> Multipart<'n, 'd>

pub fn new() -> Self

Initialize a new lazy dynamic request.

pub fn add_text<N, T>(&mut self, name: N, text: T) -> &mut Self where
    N: Into<Cow<'n, str>>,
    T: Into<Cow<'d, str>>, 

Add a text field to this request.

pub fn add_file<N, P>(&mut self, name: N, path: P) -> &mut Self where
    N: Into<Cow<'n, str>>,
    P: IntoCowPath<'d>, 

Add a file field to this request.

Note

Does not check if path exists.

pub fn add_stream<N, R, F>(
    &mut self,
    name: N,
    stream: R,
    filename: Option<F>,
    mime: Option<Mime>
) -> &mut Self where
    N: Into<Cow<'n, str>>,
    R: Read + 'd,
    F: Into<Cow<'n, str>>, 

Add a generic stream field to this request,

pub fn send<R: HttpRequest>(
    &mut self,
    req: R
) -> Result<<R::Stream as HttpStream>::Response, LazyError<'n, <R::Stream as HttpStream>::Error>>

Convert req to HttpStream, write out the fields in this request, and finish the request, returning the response if successful, or the first error encountered.

If any files were added by path they will now be opened for reading.

pub fn prepare(&mut self) -> LazyIoResult<'n, PreparedFields<'d>>

Export the multipart data contained in this lazy request as an adaptor which implements Read.

During this step, if any files were added by path then they will be opened for reading and their length measured.

Trait Implementations

impl<'n, 'd> Debug for Multipart<'n, 'd>

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

Formats the value using the given formatter.

impl<'n, 'd> Default for Multipart<'n, 'd>

fn default() -> Multipart<'n, 'd>

Returns the "default value" for a type.