Trait HttpBody

pub trait HttpBody {
    type Data: Buf;
    type Error;

    // Required method
    fn poll_frame(
        self: Pin<&mut Self>,
        cx: &mut Context<'_>,
    ) -> Poll<Option<Result<Frame<Self::Data>, Self::Error>>>;

    // Provided methods
    fn is_end_stream(&self) -> bool { ... }
    fn size_hint(&self) -> SizeHint { ... }
}
Expand description

Trait representing a streaming body of a Request or Response.

Individual frames are streamed via the poll_frame function, which asynchronously yields instances of [Frame<Data>].

Frames can contain a data buffer of type Self::Data. Frames can also contain an optional set of trailers used to finalize the request/response exchange. This is mostly used when using the HTTP/2.0 protocol.

The size_hint function provides insight into the total number of bytes that will be streamed.

Required Associated Typesยง

type Data: Buf

Values yielded by the Body.

type Error

The error type this Body might generate.

Required Methodsยง

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

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

Provided Methodsยง

fn is_end_stream(&self) -> bool

Returns true when the end of stream has been reached.

An end of stream means that poll_frame will return None.

A return value of false does not guarantee that a value will be returned from poll_frame.

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.

Implementations on Foreign Typesยง

ยง

impl Body for String

ยง

type Data = Bytes

ยง

type Error = Infallible

ยง

fn poll_frame( self: Pin<&mut String>, _cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<String as Body>::Data>, <String as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl Body for Body

ยง

type Data = Bytes

ยง

type Error = Error

ยง

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

ยง

fn size_hint(&self) -> SizeHint

ยง

fn is_end_stream(&self) -> bool

ยง

impl Body for Full

ยง

type Data = Bytes

ยง

type Error = Infallible

ยง

fn poll_frame( self: Pin<&mut Full>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<Full as Body>::Data>, <Full as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl Body for Incoming

ยง

type Data = Bytes

ยง

type Error = Error

ยง

fn poll_frame( self: Pin<&mut Incoming>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<Incoming as Body>::Data>, <Incoming as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl Body for ResponseBody

ยง

type Data = <UnsyncBoxBody<Bytes, Error> as Body>::Data

ยง

type Error = <UnsyncBoxBody<Bytes, Error> as Body>::Error

ยง

fn poll_frame( self: Pin<&mut ResponseBody>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<ResponseBody as Body>::Data>, <ResponseBody as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = <B as Body>::Data

ยง

type Error = <B as Body>::Error

ยง

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

ยง

impl<B> Body for Collected<B>
where B: Buf,

ยง

type Data = B

ยง

type Error = Infallible

ยง

fn poll_frame( self: Pin<&mut Collected<B>>, _: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<Collected<B> as Body>::Data>, <Collected<B> as Body>::Error>>>

ยง

impl<B> Body for Limited<B>
where B: Body, <B as Body>::Error: Into<Box<dyn Error + Send + Sync>>,

ยง

type Data = <B as Body>::Data

ยง

type Error = Box<dyn Error + Send + Sync>

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl<B> Body for Limited<B>
where B: Body, <B as Body>::Error: Into<Box<dyn Error + Send + Sync>>,

ยง

type Data = <B as Body>::Data

ยง

type Error = Box<dyn Error + Send + Sync>

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl<B, C, OnBodyChunkT, OnEosT, OnFailureT> Body for ResponseBody<B, C, OnBodyChunkT, OnEosT, OnFailureT>
where B: Body, <B as Body>::Error: Display + 'static, C: ClassifyEos, OnEosT: OnEos, OnBodyChunkT: OnBodyChunk<<B as Body>::Data>, OnFailureT: OnFailure<<C as ClassifyEos>::FailureClass>,

ยง

type Data = <B as Body>::Data

ยง

type Error = <B as Body>::Error

ยง

fn poll_frame( self: Pin<&mut ResponseBody<B, C, OnBodyChunkT, OnEosT, OnFailureT>>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<ResponseBody<B, C, OnBodyChunkT, OnEosT, OnFailureT> as Body>::Data>, <ResponseBody<B, C, OnBodyChunkT, OnEosT, OnFailureT> as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = B2

ยง

type Error = <B as Body>::Error

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

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

ยง

type Data = <B as Body>::Data

ยง

type Error = E

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = D

ยง

type Error = Infallible

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = D

ยง

type Error = Infallible

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = D

ยง

type Error = E

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = D

ยง

type Error = E

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = D

ยง

type Error = E

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl<L, R, Data> Body for Either<L, R>
where L: Body<Data = Data>, R: Body<Data = Data>, <L as Body>::Error: Into<Box<dyn Error + Send + Sync>>, <R as Body>::Error: Into<Box<dyn Error + Send + Sync>>, Data: Buf,

ยง

type Data = Data

ยง

type Error = Box<dyn Error + Send + Sync>

ยง

fn poll_frame( self: Pin<&mut Either<L, R>>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<Either<L, R> as Body>::Data>, <Either<L, R> as Body>::Error>>>

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl<S, D, E> Body for StreamBody<S>
where S: Stream<Item = Result<Frame<D>, E>>, D: Buf,

ยง

type Data = D

ยง

type Error = E

ยง

fn poll_frame( self: Pin<&mut StreamBody<S>>, cx: &mut Context<'_>, ) -> Poll<Option<Result<Frame<<StreamBody<S> as Body>::Data>, <StreamBody<S> as Body>::Error>>>

ยง

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

ยง

type Data = <T as Body>::Data

ยง

type Error = <T as Body>::Error

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

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

ยง

type Data = <T as Body>::Data

ยง

type Error = <T as Body>::Error

ยง

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

ยง

fn is_end_stream(&self) -> bool

ยง

fn size_hint(&self) -> SizeHint

ยง

impl<T> Body for AsyncReadBody<T>
where T: AsyncRead,

ยง

type Data = Bytes

ยง

type Error = Error

ยง

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

ยง

impl<T, F> Body for WithTrailers<T, F>
where T: Body, F: Future<Output = Option<Result<HeaderMap, <T as Body>::Error>>>,

ยง

type Data = <T as Body>::Data

ยง

type Error = <T as Body>::Error

ยง

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

ยง

fn size_hint(&self) -> SizeHint

Implementorsยง

ยง

impl Body for flams_router_vscode::server_fn::axum_export::body::Body

ยง

impl Body for BodyDataStream

ยง

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

ยง

type Data = <B as Body>::Data

ยง

type Error = <B as Body>::Error

ยง

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

ยง

type Data = <B as Body>::Data

ยง

type Error = <B as Body>::Error

ยง

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