Struct HeadBody 

pub struct HeadBody { /* private fields */ }

An empty body retaining the representation length for a HEAD response.

Implementations

impl HeadBody

pub const fn new(length: Option<u64>) -> Self

pub fn for_body<B: ReadableBody + ?Sized>(body: &mut B) -> Self

Capture the representation length and close the supplied body.

Trait Implementations

impl Clone for HeadBody

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HeadBody

impl Debug for HeadBody

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

Formats the value using the given formatter.

impl Default for HeadBody

fn default() -> Self

Returns the “default value” for a type.

impl ReadableBody for HeadBody

type Data = Vec<u8>

Application data, without imposing completion-I/O buffer requirements.

type Error = Cancelled

fn may_have_trailers(&self) -> bool

Whether this body can emit trailing headers. HTTP/1 needs this before reading to choose chunked framing, even when the data length is known. Returning false promises that no Headers frame will be produced.

fn is_ready(&self) -> bool

Whether another read can proceed without waiting for produced data.

fn is_empty(&self) -> bool

Whether no unread payload frames remain. False can mean unknown; an open queue with no frames is not exhausted. This does not suppress read errors.

fn length(&self) -> Option<u64>

Total representation length, independent of the current read position.

fn close(&mut self, _error: Option<Self::Error>)

Abandon further application reads, optionally reporting their failure.

async fn read( &mut self, cancellation: &Cancellation, ) -> Result<BodyFrame<Self::Data>, Self::Error>

Read one owned frame. Pre-cancellation prevents consumption. The caller stops after frame.is_end(); subsequent reads return BodyFrame::End. Headers occur at most once, after all data. Dropping a pending read is not transport retirement, and must not lose an unreturned queued frame.

fn is_rewindable(&self) -> bool

fn rewind(&mut self) -> bool

Restore the read position when supported, reporting success.