[−][src]Struct body_image_futio::AsyncBodyImage
Adaptor for BodyImage
implementing the futures::Stream
and
hyper::body::Payload
traits.
The Payload
trait (plus Send
) makes this usable with hyper as the B
body type of http::Request<B>
(client) or http::Response<B>
(server). The Stream
trait is sufficient for use via
hyper::Body::with_stream
.
Tunables::buffer_size_fs
is used for reading the body when in FsRead
state. BodyImage
in Ram
is made available with zero-copy using a
consuming iterator. This implementation uses tokio_threadpool::blocking
to request becoming a backup thread for blocking reads from FsRead
state
and when dereferencing from MemMap
state (see below).
MemMap
While it works without complaint, it is not generally advisable to adapt a
BodyImage
in MemMap
state with this Payload
and Stream
type. The
Bytes
part of the contract requires a owned copy of the memory-mapped
region of memory, which contradicts the advantage of the memory-map. The
cost is confirmed by the cargo bench stream
benchmarks.
Instead use UniBodyImage
for zero-copy
MemMap
support, at the cost of the adjustments required for not using
the default hyper::Body
type.
None of this applies, of course, if the mmap feature is disabled or if
BodyImage::mem_map
is never called.
Methods
impl AsyncBodyImage
[src]
pub fn new(body: BodyImage, tune: &Tunables) -> AsyncBodyImage
[src]
Wrap by consuming the BodyImage
instance.
Note: BodyImage
is Clone
(inexpensive), so that can be done
beforehand to preserve an owned copy.
Trait Implementations
impl RequestRecorder<AsyncBodyImage> for Builder
[src]
fn record(&mut self) -> Result<RequestRecord<AsyncBodyImage>, Error>
[src]
fn record_body<BB>(
&mut self,
body: BB
) -> Result<RequestRecord<AsyncBodyImage>, Error> where
BB: Into<Bytes>,
[src]
&mut self,
body: BB
) -> Result<RequestRecord<AsyncBodyImage>, Error> where
BB: Into<Bytes>,
fn record_body_image(
&mut self,
body: BodyImage,
tune: &Tunables
) -> Result<RequestRecord<AsyncBodyImage>, Error>
[src]
&mut self,
body: BodyImage,
tune: &Tunables
) -> Result<RequestRecord<AsyncBodyImage>, Error>
impl Debug for AsyncBodyImage
[src]
impl Stream for AsyncBodyImage
[src]
type Item = Bytes
The type of item this stream will yield on success.
type Error = Error
The type of error this stream may generate.
fn poll(&mut self) -> Poll<Option<Bytes>, Error>
[src]
fn wait(self) -> Wait<Self>
[src]
fn into_future(self) -> StreamFuture<Self>
[src]
fn map<U, F>(self, f: F) -> Map<Self, F> where
F: FnMut(Self::Item) -> U,
[src]
F: FnMut(Self::Item) -> U,
fn map_err<U, F>(self, f: F) -> MapErr<Self, F> where
F: FnMut(Self::Error) -> U,
[src]
F: FnMut(Self::Error) -> U,
fn filter<F>(self, f: F) -> Filter<Self, F> where
F: FnMut(&Self::Item) -> bool,
[src]
F: FnMut(&Self::Item) -> bool,
fn filter_map<F, B>(self, f: F) -> FilterMap<Self, F> where
F: FnMut(Self::Item) -> Option<B>,
[src]
F: FnMut(Self::Item) -> Option<B>,
fn then<F, U>(self, f: F) -> Then<Self, F, U> where
F: FnMut(Result<Self::Item, Self::Error>) -> U,
U: IntoFuture,
[src]
F: FnMut(Result<Self::Item, Self::Error>) -> U,
U: IntoFuture,
fn and_then<F, U>(self, f: F) -> AndThen<Self, F, U> where
F: FnMut(Self::Item) -> U,
U: IntoFuture<Error = Self::Error>,
[src]
F: FnMut(Self::Item) -> U,
U: IntoFuture<Error = Self::Error>,
fn or_else<F, U>(self, f: F) -> OrElse<Self, F, U> where
F: FnMut(Self::Error) -> U,
U: IntoFuture<Item = Self::Item>,
[src]
F: FnMut(Self::Error) -> U,
U: IntoFuture<Item = Self::Item>,
fn collect(self) -> Collect<Self>
[src]
fn concat2(self) -> Concat2<Self> where
Self::Item: Extend<<Self::Item as IntoIterator>::Item>,
Self::Item: IntoIterator,
Self::Item: Default,
[src]
Self::Item: Extend<<Self::Item as IntoIterator>::Item>,
Self::Item: IntoIterator,
Self::Item: Default,
fn concat(self) -> Concat<Self> where
Self::Item: Extend<<Self::Item as IntoIterator>::Item>,
Self::Item: IntoIterator,
[src]
Self::Item: Extend<<Self::Item as IntoIterator>::Item>,
Self::Item: IntoIterator,
fn fold<F, T, Fut>(self, init: T, f: F) -> Fold<Self, F, Fut, T> where
F: FnMut(T, Self::Item) -> Fut,
Fut: IntoFuture<Item = T>,
Self::Error: From<<Fut as IntoFuture>::Error>,
[src]
F: FnMut(T, Self::Item) -> Fut,
Fut: IntoFuture<Item = T>,
Self::Error: From<<Fut as IntoFuture>::Error>,
fn flatten(self) -> Flatten<Self> where
Self::Item: Stream,
<Self::Item as Stream>::Error: From<Self::Error>,
[src]
Self::Item: Stream,
<Self::Item as Stream>::Error: From<Self::Error>,
fn skip_while<P, R>(self, pred: P) -> SkipWhile<Self, P, R> where
P: FnMut(&Self::Item) -> R,
R: IntoFuture<Item = bool, Error = Self::Error>,
[src]
P: FnMut(&Self::Item) -> R,
R: IntoFuture<Item = bool, Error = Self::Error>,
fn take_while<P, R>(self, pred: P) -> TakeWhile<Self, P, R> where
P: FnMut(&Self::Item) -> R,
R: IntoFuture<Item = bool, Error = Self::Error>,
[src]
P: FnMut(&Self::Item) -> R,
R: IntoFuture<Item = bool, Error = Self::Error>,
fn for_each<F, U>(self, f: F) -> ForEach<Self, F, U> where
F: FnMut(Self::Item) -> U,
U: IntoFuture<Item = (), Error = Self::Error>,
[src]
F: FnMut(Self::Item) -> U,
U: IntoFuture<Item = (), Error = Self::Error>,
fn from_err<E>(self) -> FromErr<Self, E> where
E: From<Self::Error>,
[src]
E: From<Self::Error>,
fn take(self, amt: u64) -> Take<Self>
[src]
fn skip(self, amt: u64) -> Skip<Self>
[src]
fn fuse(self) -> Fuse<Self>
[src]
fn by_ref(&mut self) -> &mut Self
[src]
fn catch_unwind(self) -> CatchUnwind<Self> where
Self: UnwindSafe,
[src]
Self: UnwindSafe,
fn buffered(self, amt: usize) -> Buffered<Self> where
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error == Self::Error,
[src]
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error == Self::Error,
fn buffer_unordered(self, amt: usize) -> BufferUnordered<Self> where
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error == Self::Error,
[src]
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error == Self::Error,
fn merge<S>(self, other: S) -> Merge<Self, S> where
S: Stream<Error = Self::Error>,
[src]
S: Stream<Error = Self::Error>,
fn zip<S>(self, other: S) -> Zip<Self, S> where
S: Stream<Error = Self::Error>,
[src]
S: Stream<Error = Self::Error>,
fn chain<S>(self, other: S) -> Chain<Self, S> where
S: Stream<Item = Self::Item, Error = Self::Error>,
[src]
S: Stream<Item = Self::Item, Error = Self::Error>,
fn peekable(self) -> Peekable<Self>
[src]
fn chunks(self, capacity: usize) -> Chunks<Self>
[src]
fn select<S>(self, other: S) -> Select<Self, S> where
S: Stream<Item = Self::Item, Error = Self::Error>,
[src]
S: Stream<Item = Self::Item, Error = Self::Error>,
fn forward<S>(self, sink: S) -> Forward<Self, S> where
S: Sink<SinkItem = Self::Item>,
Self::Error: From<<S as Sink>::SinkError>,
[src]
S: Sink<SinkItem = Self::Item>,
Self::Error: From<<S as Sink>::SinkError>,
fn split(self) -> (SplitSink<Self>, SplitStream<Self>) where
Self: Sink,
[src]
Self: Sink,
fn inspect<F>(self, f: F) -> Inspect<Self, F> where
F: FnMut(&Self::Item),
[src]
F: FnMut(&Self::Item),
fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where
F: FnMut(&Self::Error),
[src]
F: FnMut(&Self::Error),
impl Payload for AsyncBodyImage
[src]
type Data = Cursor<Bytes>
A buffer of bytes representing a single chunk of a body.
type Error = Error
The error type of this stream.
fn poll_data(&mut self) -> Poll<Option<Self::Data>, Error>
[src]
fn content_length(&self) -> Option<u64>
[src]
fn is_end_stream(&self) -> bool
[src]
fn poll_trailers(
&mut self
) -> Result<Async<Option<HeaderMap<HeaderValue>>>, Self::Error>
[src]
&mut self
) -> Result<Async<Option<HeaderMap<HeaderValue>>>, Self::Error>
Auto Trait Implementations
impl Send for AsyncBodyImage
impl Unpin for AsyncBodyImage
impl Sync for AsyncBodyImage
impl UnwindSafe for AsyncBodyImage
impl RefUnwindSafe for AsyncBodyImage
Blanket Implementations
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> StreamExt for T where
T: Stream + ?Sized,
[src]
T: Stream + ?Sized,
fn throttle(self, duration: Duration) -> Throttle<Self>
[src]
fn enumerate(self) -> Enumerate<Self>
[src]
fn timeout(self, timeout: Duration) -> Timeout<Self>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,