Struct multipart::server::Multipart
[−]
[src]
pub struct Multipart<R> { /* fields omitted */ }
The server-side implementation of multipart/form-data
requests.
Implements Borrow<R>
to allow access to the request body, if desired.
Methods
impl Multipart<()>
[src]
impl Multipart<()>
pub fn from_request<R: HttpRequest>(req: R) -> Result<Multipart<R::Body>, R>
[src]
pub fn from_request<R: HttpRequest>(req: R) -> Result<Multipart<R::Body>, R>
If the given HttpRequest
is a multipart/form-data POST request,
return the request body wrapped in the multipart reader. Otherwise,
returns the original request.
impl<R: Read> Multipart<R>
[src]
impl<R: Read> Multipart<R>
pub fn with_body<Bnd: Into<String>>(body: R, boundary: Bnd) -> Self
[src]
pub fn with_body<Bnd: Into<String>>(body: R, boundary: Bnd) -> Self
Construct a new Multipart
with the given body reader and boundary.
Note: boundary
This will prepend the requisite --
to the boundary string as documented in
IETF RFC 1341, Section 7.2.1: "Multipart: the common syntax".
Simply pass the value of the boundary
key from the Content-Type
header in the
request (or use Multipart::from_request()
, if supported).
pub fn read_entry(&mut self) -> Result<Option<MultipartField<&mut Self>>>
[src]
pub fn read_entry(&mut self) -> Result<Option<MultipartField<&mut Self>>>
Read the next entry from this multipart request, returning a struct with the field's name and
data. See MultipartField
for more info.
Warning: Risk of Data Loss
If the previously returned entry had contents of type MultipartField::File
,
calling this again will discard any unread contents of that entry.
pub fn into_entry(self) -> ReadEntryResult<Self>
[src]
pub fn into_entry(self) -> ReadEntryResult<Self>
Read the next entry from this multipart request, returning a struct with the field's name and
data. See MultipartField
for more info.
pub fn foreach_entry<F>(&mut self, foreach: F) -> Result<()> where
F: FnMut(MultipartField<&mut Self>),
[src]
pub fn foreach_entry<F>(&mut self, foreach: F) -> Result<()> where
F: FnMut(MultipartField<&mut Self>),
Call f
for each entry in the multipart request.
This is a substitute for Rust not supporting streaming iterators (where the return value
from next()
borrows the iterator for a bound lifetime).
Returns Ok(())
when all fields have been read, or the first error.
pub fn save(&mut self) -> SaveBuilder<&mut Self>
[src]
pub fn save(&mut self) -> SaveBuilder<&mut Self>
Get a builder type for saving the files in this request to the filesystem.
See SaveBuilder
for more information.