Struct tower::balance::p2c::Balance [−][src]
balance
only.Expand description
Efficiently distributes requests across an arbitrary number of services.
See the module-level documentation for details.
Note that Balance
requires that the Discover
you use is Unpin
in order to implement
Service
. This is because it needs to be accessed from Service::poll_ready
, which takes
&mut self
. You can achieve this easily by wrapping your Discover
in Box::pin
before you
construct the Balance
instance. For more details, see #319.
Implementations
Constructs a load balancer seeded with the provided random number generator.
Trait Implementations
The future response value.
Returns Poll::Ready(Ok(()))
when the service is able to process requests. Read more
Auto Trait Implementations
impl<D, Req> !RefUnwindSafe for Balance<D, Req>
impl<D, Req> Send for Balance<D, Req> where
D: Send,
Req: Send,
<D as Discover>::Key: Send,
<D as Discover>::Service: Send,
impl<D, Req> Sync for Balance<D, Req> where
D: Sync,
Req: Sync,
<D as Discover>::Key: Sync,
<D as Discover>::Service: Sync,
impl<D, Req> !UnwindSafe for Balance<D, Req>
Blanket Implementations
Mutably borrows from an owned value. Read more
util
only.Yields a mutable reference to the service when it is ready to accept a request.
please use the ServiceExt::ready
method instead
util
only.Yields a mutable reference to the service when it is ready to accept a request.
fn ready_oneshot(self) -> ReadyOneshot<Self, Request>ⓘNotable traits for ReadyOneshot<T, Request>impl<T, Request> Future for ReadyOneshot<T, Request> where
T: Service<Request>, type Output = Result<T, T::Error>;
where
Self: Sized,
fn ready_oneshot(self) -> ReadyOneshot<Self, Request>ⓘNotable traits for ReadyOneshot<T, Request>impl<T, Request> Future for ReadyOneshot<T, Request> where
T: Service<Request>, type Output = Result<T, T::Error>;
where
Self: Sized,
impl<T, Request> Future for ReadyOneshot<T, Request> where
T: Service<Request>, type Output = Result<T, T::Error>;
util
only.Yields the service when it is ready to accept a request.
util
only.Consume this Service
, calling with the providing request once it is ready.
util
only.util
only.Executes a new future after this service’s future resolves. This does
not alter the behaviour of the poll_ready
method. Read more
fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F> where
Self: Sized,
F: FnOnce(Self::Response) -> Response + Clone,
fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F> where
Self: Sized,
F: FnOnce(Self::Response) -> Response + Clone,
util
only.Maps this service’s response value to a different value. This does not
alter the behaviour of the poll_ready
method. Read more
util
only.Maps this service’s error value to a different value. This does not
alter the behaviour of the poll_ready
method. Read more
util
only.Maps this service’s result type (Result<Self::Response, Self::Error>
)
to a different value, regardless of whether the future succeeds or
fails. Read more
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F> where
Self: Sized,
F: FnMut(NewRequest) -> Request + Clone,
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F> where
Self: Sized,
F: FnMut(NewRequest) -> Request + Clone,
util
only.Composes a function in front of the service. Read more
util
and filter
only.fn filter_async<F, NewRequest>(self, filter: F) -> AsyncFilter<Self, F> where
Self: Sized,
F: AsyncPredicate<NewRequest>,
fn filter_async<F, NewRequest>(self, filter: F) -> AsyncFilter<Self, F> where
Self: Sized,
F: AsyncPredicate<NewRequest>,
util
and filter
only.Composes this service with an AsyncFilter
that conditionally accepts or
rejects requests based on an [async predicate]. Read more
util
only.Composes an asynchronous function after this service. Read more
util
only.Composes a function that transforms futures produced by the service. Read more
pub fn vzip(self) -> V
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more