Struct BodyStream 

pub struct BodyStream { /* private fields */ }

A request body that is read in pieces, see the module documentation

Implementations

impl BodyStream

pub fn content_length(&self) -> Option<u64>

Size announced by the client (Content-Length), if any. Untrusted; the limit is checked against what actually arrives.

pub fn bytes_read(&self) -> u64

Bytes delivered so far

pub async fn chunk(&mut self) -> Result<Option<Bytes>>

The next piece, or None at the end. Fails with 413 as soon as the limit is exceeded, and with 400 when the connection breaks mid-body.

pub async fn copy_to<W: AsyncWrite + Unpin>( &mut self, writer: &mut W, ) -> Result<u64>

Write the rest of the body to writer; returns the bytes copied

pub async fn save_to(&mut self, path: impl AsRef<Path>) -> Result<u64>

Write the rest of the body to a file; returns the bytes written

The file is created or replaced. If the body is cut off, too large or the write fails, the partial file is removed. Use a temporary name and rename it afterwards when readers must never see half-written data.

pub async fn collect(&mut self) -> Result<Bytes>

Read the rest into memory, still bounded by the limit