[−][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]
impl AsyncBodyImage
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]
impl RequestRecorder<AsyncBodyImage> for Builder
fn record(&mut self) -> Result<RequestRecord<AsyncBodyImage>, Flare> | [src] |
fn record_body<BB>( | [src] |
fn record_body_image( | [src] |
impl Debug for AsyncBodyImage
[src]
impl Debug for AsyncBodyImage
impl Stream for AsyncBodyImage
[src]
impl Stream for AsyncBodyImage
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] |
Creates an iterator which blocks the current thread until each item of this stream is resolved. Read more
fn into_future(self) -> StreamFuture<Self> | [src] |
Converts this stream into a Future
. Read more
fn map<U, F>(self, f: F) -> Map<Self, F> where | [src] |
Converts a stream of type T
to a stream of type U
. Read more
fn map_err<U, F>(self, f: F) -> MapErr<Self, F> where | [src] |
Converts a stream of error type T
to a stream of error type U
. Read more
fn filter<F>(self, f: F) -> Filter<Self, F> where | [src] |
Filters the values produced by this stream according to the provided predicate. Read more
fn filter_map<F, B>(self, f: F) -> FilterMap<Self, F> where | [src] |
Filters the values produced by this stream while simultaneously mapping them to a different type. Read more
fn then<F, U>(self, f: F) -> Then<Self, F, U> where | [src] |
Chain on a computation for when a value is ready, passing the resulting item to the provided closure f
. Read more
fn and_then<F, U>(self, f: F) -> AndThen<Self, F, U> where | [src] |
Chain on a computation for when a value is ready, passing the successful results to the provided closure f
. Read more
fn or_else<F, U>(self, f: F) -> OrElse<Self, F, U> where | [src] |
Chain on a computation for when an error happens, passing the erroneous result to the provided closure f
. Read more
fn collect(self) -> Collect<Self> | [src] |
Collect all of the values of this stream into a vector, returning a future representing the result of that computation. Read more
fn concat2(self) -> Concat2<Self> where | [src] |
Concatenate all results of a stream into a single extendable destination, returning a future representing the end result. Read more
fn concat(self) -> Concat<Self> where | [src] |
please use Stream::concat2
instead
Concatenate all results of a stream into a single extendable destination, returning a future representing the end result. Read more
fn fold<F, T, Fut>(self, init: T, f: F) -> Fold<Self, F, Fut, T> where | [src] |
Execute an accumulating computation over a stream, collecting all the values into one final result. Read more
fn flatten(self) -> Flatten<Self> where | [src] |
Flattens a stream of streams into just one continuous stream. Read more
fn skip_while<P, R>(self, pred: P) -> SkipWhile<Self, P, R> where | [src] |
Skip elements on this stream while the predicate provided resolves to true
. Read more
fn take_while<P, R>(self, pred: P) -> TakeWhile<Self, P, R> where | [src] |
Take elements from this stream while the predicate provided resolves to true
. Read more
fn for_each<F, U>(self, f: F) -> ForEach<Self, F, U> where | [src] |
Runs this stream to completion, executing the provided closure for each element on the stream. Read more
fn from_err<E>(self) -> FromErr<Self, E> where | [src] |
Map this stream's error to any error implementing From
for this stream's Error
, returning a new stream. Read more
fn take(self, amt: u64) -> Take<Self> | [src] |
Creates a new stream of at most amt
items of the underlying stream. Read more
fn skip(self, amt: u64) -> Skip<Self> | [src] |
Creates a new stream which skips amt
items of the underlying stream. Read more
fn fuse(self) -> Fuse<Self> | [src] |
Fuse a stream such that poll
will never again be called once it has finished. Read more
fn by_ref(&mut self) -> &mut Self | [src] |
Borrows a stream, rather than consuming it. Read more
fn catch_unwind(self) -> CatchUnwind<Self> where | [src] |
Catches unwinding panics while polling the stream. Read more
fn buffered(self, amt: usize) -> Buffered<Self> where | [src] |
An adaptor for creating a buffered list of pending futures. Read more
fn buffer_unordered(self, amt: usize) -> BufferUnordered<Self> where | [src] |
An adaptor for creating a buffered list of pending futures (unordered). Read more
fn merge<S>(self, other: S) -> Merge<Self, S> where | [src] |
functionality provided by select
now
An adapter for merging the output of two streams. Read more
fn zip<S>(self, other: S) -> Zip<Self, S> where | [src] |
An adapter for zipping two streams together. Read more
fn chain<S>(self, other: S) -> Chain<Self, S> where | [src] |
Adapter for chaining two stream. Read more
fn peekable(self) -> Peekable<Self> | [src] |
Creates a new stream which exposes a peek
method. Read more
fn chunks(self, capacity: usize) -> Chunks<Self> | [src] |
An adaptor for chunking up items of the stream inside a vector. Read more
fn select<S>(self, other: S) -> Select<Self, S> where | [src] |
Creates a stream that selects the next element from either this stream or the provided one, whichever is ready first. Read more
fn forward<S>(self, sink: S) -> Forward<Self, S> where | [src] |
A future that completes after the given stream has been fully processed into the sink, including flushing. Read more
fn split(self) -> (SplitSink<Self>, SplitStream<Self>) where | [src] |
Splits this Stream + Sink
object into separate Stream
and Sink
objects. Read more
fn inspect<F>(self, f: F) -> Inspect<Self, F> where | [src] |
Do something with each item of this stream, afterwards passing it on. Read more
fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where | [src] |
Do something with the error of this stream, afterwards passing it on. Read more
impl Payload for AsyncBodyImage
[src]
impl Payload for AsyncBodyImage
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( | [src] |
Poll for an optional single HeaderMap
of trailers. Read more
Auto Trait Implementations
impl Send for AsyncBodyImage
impl Send for AsyncBodyImage
impl !Sync for AsyncBodyImage
impl !Sync for AsyncBodyImage
Blanket Implementations
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)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> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T | [src] |
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error> | [src] |
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId | [src] |
impl<T> Erased for T
impl<T> Erased for T
impl<T> StreamExt for T where
T: Stream + ?Sized,
[src]
impl<T> StreamExt for T where
T: Stream + ?Sized,