Trait hyper::body::HttpBody

pub trait HttpBody {
    type Data: Buf;
    type Error;
    fn poll_data(
        self: Pin<&mut Self>, 
        cx: &mut Context<'_>
    ) -> Poll<Option<Result<Self::Data, Self::Error>>>;
    fn poll_trailers(
        self: Pin<&mut Self>, 
        cx: &mut Context<'_>
    ) -> Poll<Result<Option<HeaderMap<HeaderValue>>, Self::Error>>;

    fn is_end_stream(&self) -> bool { ... }
    fn size_hint(&self) -> SizeHint { ... }
    fn data(&mut self) -> Data<'_, Self>
    where
        Self: Unpin,
    { ... }
    fn trailers(&mut self) -> Trailers<'_, Self>
    where
        Self: Unpin,
    { ... }
    fn map_data<F, B>(self, f: F) -> MapData<Self, F>
    where
        F: FnMut(Self::Data) -> B,
        B: Buf,
    { ... }
    fn map_err<F, E>(self, f: F) -> MapErr<Self, F>
    where
        F: FnMut(Self::Error) -> E,
    { ... }
    fn boxed(self) -> BoxBody<Self::Data, Self::Error>
    where
        Self: Send + Sync + 'static,
    { ... }
}

Trait representing a streaming body of a Request or Response.

Data is streamed via the poll_data function, which asynchronously yields T: Buf values. The size_hint function provides insight into the total number of bytes that will be streamed.

The poll_trailers function returns an optional set of trailers used to finalize the request / response exchange. This is mostly used when using the HTTP/2.0 protocol.

Associated Types

type Data: Buf

Values yielded by the Body.

type Error

The error type this Body might generate.

Required methods

fn poll_data(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<Self::Data, Self::Error>>>

Attempt to pull out the next data buffer of this stream.

fn poll_trailers(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, Self::Error>>

Poll for an optional single HeaderMap of trailers.

This function should only be called once poll_data returns None.

Provided methods

fn is_end_stream(&self) -> bool

Returns true when the end of stream has been reached.

An end of stream means that both poll_data and poll_trailers will return None.

A return value of false does not guarantee that a value will be returned from poll_stream or poll_trailers.

fn size_hint(&self) -> SizeHint

Returns the bounds on the remaining length of the stream.

When the exact remaining length of the stream is known, the upper bound will be set and will equal the lower bound.

fn data(&mut self) -> Data<'_, Self> where
    Self: Unpin, 

Returns future that resolves to next data chunk, if any.

fn trailers(&mut self) -> Trailers<'_, Self> where
    Self: Unpin, 

Returns future that resolves to trailers, if any.

fn map_data<F, B>(self, f: F) -> MapData<Self, F> where
    F: FnMut(Self::Data) -> B,
    B: Buf, 

Maps this body’s data value to a different value.

fn map_err<F, E>(self, f: F) -> MapErr<Self, F> where
    F: FnMut(Self::Error) -> E, 

Maps this body’s error value to a different value.

fn boxed(self) -> BoxBody<Self::Data, Self::Error> where
    Self: Send + Sync + 'static, 

Turn this body into a boxed trait object.

Implementations on Foreign Types

impl<D> Body for Full<D> where
    D: Buf, 

type Data = D

type Error = Infallible

pub fn poll_data(
    self: Pin<&mut Full<D>>,
    _cx: &mut Context<'_>
) -> Poll<Option<Result<D, <Full<D> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Full<D>>,
    _cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Full<D> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<B, F, E> Body for MapErr<B, F> where
    F: FnMut(<B as Body>::Error) -> E,
    B: Body, 

type Data = <B as Body>::Data

type Error = E

pub fn poll_data(
    self: Pin<&mut MapErr<B, F>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<MapErr<B, F> as Body>::Data, <MapErr<B, F> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut MapErr<B, F>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <MapErr<B, F> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<T> Body for Box<T, Global> where
    T: Body + Unpin + ?Sized, 

type Data = <T as Body>::Data

type Error = <T as Body>::Error

pub fn poll_data(
    self: Pin<&mut Box<T, Global>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<Box<T, Global> as Body>::Data, <Box<T, Global> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Box<T, Global>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Box<T, Global> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<D, E> Body for BoxBody<D, E> where
    D: Buf, 

type Data = D

type Error = E

pub fn poll_data(
    self: Pin<&mut BoxBody<D, E>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<BoxBody<D, E> as Body>::Data, <BoxBody<D, E> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut BoxBody<D, E>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <BoxBody<D, E> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<B, F, B2> Body for MapData<B, F> where
    F: FnMut(<B as Body>::Data) -> B2,
    B: Body,
    B2: Buf, 

type Data = B2

type Error = <B as Body>::Error

pub fn poll_data(
    self: Pin<&mut MapData<B, F>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<MapData<B, F> as Body>::Data, <MapData<B, F> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut MapData<B, F>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <MapData<B, F> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

impl<'_, T> Body for &'_ mut T where
    T: Body + Unpin + ?Sized, 

type Data = <T as Body>::Data

type Error = <T as Body>::Error

pub fn poll_data(
    self: Pin<&mut &'_ mut T>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<&'_ mut T as Body>::Data, <&'_ mut T as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut &'_ mut T>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <&'_ mut T as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<P> Body for Pin<P> where
    P: Unpin + DerefMut,
    <P as Deref>::Target: Body, 

type Data = <<P as Deref>::Target as Body>::Data

type Error = <<P as Deref>::Target as Body>::Error

pub fn poll_data(
    self: Pin<&mut Pin<P>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<Pin<P> as Body>::Data, <Pin<P> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Pin<P>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Pin<P> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<D> Body for Empty<D> where
    D: Buf, 

type Data = D

type Error = Infallible

pub fn poll_data(
    self: Pin<&mut Empty<D>>,
    _cx: &mut Context<'_>
) -> Poll<Option<Result<<Empty<D> as Body>::Data, <Empty<D> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Empty<D>>,
    _cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Empty<D> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

Implementors

impl Body for Body

type Data = Bytes

type Error = Error

fn poll_data(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<Self::Data, Self::Error>>>

fn poll_trailers(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap>, Self::Error>>

fn is_end_stream(&self) -> bool

fn size_hint(&self) -> SizeHint

impl<B> Body for Request<B> where
    B: Body, 

type Data = <B as Body>::Data

type Error = <B as Body>::Error

pub fn poll_data(
    self: Pin<&mut Request<B>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<Request<B> as Body>::Data, <Request<B> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Request<B>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Request<B> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint

impl<B> Body for Response<B> where
    B: Body, 

type Data = <B as Body>::Data

type Error = <B as Body>::Error

pub fn poll_data(
    self: Pin<&mut Response<B>>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<<Response<B> as Body>::Data, <Response<B> as Body>::Error>>>

pub fn poll_trailers(
    self: Pin<&mut Response<B>>,
    cx: &mut Context<'_>
) -> Poll<Result<Option<HeaderMap<HeaderValue>>, <Response<B> as Body>::Error>>

pub fn is_end_stream(&self) -> bool

pub fn size_hint(&self) -> SizeHint