pub struct Pool<MS, Target, Request>where
MS: MakeService<Target, Request>,
MS::MakeError: Into<BoxError>,
MS::Error: Into<BoxError>,
Target: Clone,{ /* private fields */ }
Expand description
A dynamically sized, load-balanced pool of Service
instances.
Implementations§
source§impl<MS, Target, Request> Pool<MS, Target, Request>where
MS: MakeService<Target, Request>,
MS::Service: Load,
<MS::Service as Load>::Metric: Debug,
MS::MakeError: Into<BoxError>,
MS::Error: Into<BoxError>,
Target: Clone,
impl<MS, Target, Request> Pool<MS, Target, Request>where MS: MakeService<Target, Request>, MS::Service: Load, <MS::Service as Load>::Metric: Debug, MS::MakeError: Into<BoxError>, MS::Error: Into<BoxError>, Target: Clone,
sourcepub fn new(make_service: MS, target: Target) -> Self
pub fn new(make_service: MS, target: Target) -> Self
Construct a new dynamically sized Pool
.
If many calls to poll_ready
return Pending
, new_service
is used to
construct another Service
that is then added to the load-balanced pool.
If many calls to poll_ready
succeed, the most recently added Service
is dropped from the pool.
Trait Implementations§
source§impl<MS, Target, Request> Debug for Pool<MS, Target, Request>where
MS: MakeService<Target, Request> + Debug,
MS::MakeError: Into<BoxError>,
MS::Error: Into<BoxError>,
Target: Clone + Debug,
MS::Service: Debug,
impl<MS, Target, Request> Debug for Pool<MS, Target, Request>where MS: MakeService<Target, Request> + Debug, MS::MakeError: Into<BoxError>, MS::Error: Into<BoxError>, Target: Clone + Debug, MS::Service: Debug,
source§impl<MS, Target, Req> Service<Req> for Pool<MS, Target, Req>where
MS: MakeService<Target, Req>,
MS::Service: Load,
<MS::Service as Load>::Metric: Debug,
MS::MakeError: Into<BoxError>,
MS::Error: Into<BoxError>,
Target: Clone,
impl<MS, Target, Req> Service<Req> for Pool<MS, Target, Req>where MS: MakeService<Target, Req>, MS::Service: Load, <MS::Service as Load>::Metric: Debug, MS::MakeError: Into<BoxError>, MS::Error: Into<BoxError>, Target: Clone,
§type Response = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Response
type Response = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Response
Responses given by the service.
§type Error = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Error
type Error = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Error
Errors produced by the service.
§type Future = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Future
type Future = <Balance<Pin<Box<PoolDiscoverer<MS, Target, Req>, Global>>, Req> as Service<Req>>::Future
The future response value.
Auto Trait Implementations§
impl<MS, Target, Request> !RefUnwindSafe for Pool<MS, Target, Request>
impl<MS, Target, Request> Send for Pool<MS, Target, Request>where MS: Send, Request: Send, Target: Send, <MS as MakeService<Target, Request>>::Future: Send, <MS as MakeService<Target, Request>>::Service: Send,
impl<MS, Target, Request> Sync for Pool<MS, Target, Request>where MS: Sync, Request: Send + Sync, Target: Sync, <MS as MakeService<Target, Request>>::Future: Sync, <MS as MakeService<Target, Request>>::Service: Send + Sync,
impl<MS, Target, Request> Unpin for Pool<MS, Target, Request>where Request: Unpin,
impl<MS, Target, Request> !UnwindSafe for Pool<MS, Target, Request>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<M, S, Target, Request> MakeService<Target, Request> for Mwhere
M: Service<Target, Response = S>,
S: Service<Request>,
impl<M, S, Target, Request> MakeService<Target, Request> for Mwhere M: Service<Target, Response = S>, S: Service<Request>,
source§fn poll_ready(
&mut self,
cx: &mut Context<'_>
) -> Poll<Result<(), <M as MakeService<Target, Request>>::MakeError>>
fn poll_ready( &mut self, cx: &mut Context<'_> ) -> Poll<Result<(), <M as MakeService<Target, Request>>::MakeError>>
Returns
Poll::Ready
when the factory is able to create more services. Read moresource§fn make_service(
&mut self,
target: Target
) -> <M as MakeService<Target, Request>>::Future
fn make_service( &mut self, target: Target ) -> <M as MakeService<Target, Request>>::Future
Create and return a new service value asynchronously.
source§fn into_service(self) -> IntoService<Self, Request>where
Self: Sized,
fn into_service(self) -> IntoService<Self, Request>where Self: Sized,
source§fn as_service(&mut self) -> AsService<'_, Self, Request>where
Self: Sized,
fn as_service(&mut self) -> AsService<'_, Self, Request>where Self: Sized,
source§impl<T, Request> ServiceExt<Request> for Twhere
T: Service<Request> + ?Sized,
impl<T, Request> ServiceExt<Request> for Twhere T: Service<Request> + ?Sized,
source§fn ready(&mut self) -> Ready<'_, Self, Request> ⓘwhere
Self: Sized,
fn ready(&mut self) -> Ready<'_, Self, Request> ⓘwhere Self: Sized,
Yields a mutable reference to the service when it is ready to accept a request.
source§fn ready_and(&mut self) -> ReadyAnd<'_, Self, Request>where
Self: Sized,
fn ready_and(&mut self) -> ReadyAnd<'_, Self, Request>where Self: Sized,
👎Deprecated since 0.4.6: please use the
ServiceExt::ready
method insteadYields a mutable reference to the service when it is ready to accept a request.
source§fn ready_oneshot(self) -> ReadyOneshot<Self, Request> ⓘwhere
Self: Sized,
fn ready_oneshot(self) -> ReadyOneshot<Self, Request> ⓘwhere Self: Sized,
Yields the service when it is ready to accept a request.
source§fn oneshot(self, req: Request) -> Oneshot<Self, Request> ⓘwhere
Self: Sized,
fn oneshot(self, req: Request) -> Oneshot<Self, Request> ⓘwhere Self: Sized,
Consume this
Service
, calling with the providing request once it is ready.source§fn call_all<S>(self, reqs: S) -> CallAll<Self, S>where
Self: Sized,
Self::Error: Into<BoxError>,
S: Stream<Item = Request>,
fn call_all<S>(self, reqs: S) -> CallAll<Self, S>where Self: Sized, Self::Error: Into<BoxError>, S: Stream<Item = Request>,
source§fn and_then<F>(self, f: F) -> AndThen<Self, F>where
Self: Sized,
F: Clone,
fn and_then<F>(self, f: F) -> AndThen<Self, F>where Self: Sized, F: Clone,
Executes a new future after this service’s future resolves. This does
not alter the behaviour of the
poll_ready
method. Read moresource§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,
Maps this service’s response value to a different value. This does not
alter the behaviour of the
poll_ready
method. Read moresource§fn map_err<F, Error>(self, f: F) -> MapErr<Self, F>where
Self: Sized,
F: FnOnce(Self::Error) -> Error + Clone,
fn map_err<F, Error>(self, f: F) -> MapErr<Self, F>where Self: Sized, F: FnOnce(Self::Error) -> Error + Clone,
Maps this service’s error value to a different value. This does not
alter the behaviour of the
poll_ready
method. Read moresource§fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F>where
Self: Sized,
Error: From<Self::Error>,
F: FnOnce(Result<Self::Response, Self::Error>) -> Result<Response, Error> + Clone,
fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F>where Self: Sized, Error: From<Self::Error>, F: FnOnce(Result<Self::Response, Self::Error>) -> Result<Response, Error> + Clone,
Maps this service’s result type (
Result<Self::Response, Self::Error>
)
to a different value, regardless of whether the future succeeds or
fails. Read moresource§fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F>where
Self: Sized,
F: FnMut(NewRequest) -> Request,
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F>where Self: Sized, F: FnMut(NewRequest) -> Request,
Composes a function in front of the service. Read more
source§fn then<F, Response, Error, Fut>(self, f: F) -> Then<Self, F>where
Self: Sized,
Error: From<Self::Error>,
F: FnOnce(Result<Self::Response, Self::Error>) -> Fut + Clone,
Fut: Future<Output = Result<Response, Error>>,
fn then<F, Response, Error, Fut>(self, f: F) -> Then<Self, F>where Self: Sized, Error: From<Self::Error>, F: FnOnce(Result<Self::Response, Self::Error>) -> Fut + Clone, Fut: Future<Output = Result<Response, Error>>,
Composes an asynchronous function after this service. Read more
source§fn map_future<F, Fut, Response, Error>(self, f: F) -> MapFuture<Self, F>where
Self: Sized,
F: FnMut(Self::Future) -> Fut,
Error: From<Self::Error>,
Fut: Future<Output = Result<Response, Error>>,
fn map_future<F, Fut, Response, Error>(self, f: F) -> MapFuture<Self, F>where Self: Sized, F: FnMut(Self::Future) -> Fut, Error: From<Self::Error>, Fut: Future<Output = Result<Response, Error>>,
Composes a function that transforms futures produced by the service. Read more