Trait actix_net::service::ServiceExt
source · pub trait ServiceExt: Service {
fn apply<S, I, F, R>(
self,
service: I,
f: F
) -> AndThen<Self, Apply<S, F, R, Self::Response>>
where
Self: Sized,
S: Service,
S::Error: Into<<R::Future as Future>::Error>,
I: IntoService<S>,
F: Fn(Self::Response, &mut S) -> R,
R: IntoFuture<Error = Self::Error>,
{ ... }
fn and_then<F, B>(self, service: F) -> AndThen<Self, B>
where
Self: Sized,
F: IntoService<B>,
B: Service<Request = Self::Response, Error = Self::Error>,
{ ... }
fn from_err<E>(self) -> FromErr<Self, E>
where
Self: Sized,
E: From<Self::Error>,
{ ... }
fn then<B>(self, service: B) -> Then<Self, B>
where
Self: Sized,
B: Service<Request = Result<Self::Response, Self::Error>, Error = Self::Error>,
{ ... }
fn map<F, R>(self, f: F) -> Map<Self, F, R>
where
Self: Sized,
F: Fn(Self::Response) -> R,
{ ... }
fn map_err<F, E>(self, f: F) -> MapErr<Self, F, E>
where
Self: Sized,
F: Fn(Self::Error) -> E,
{ ... }
}
Expand description
An extension trait for Service
s that provides a variety of convenient
adapters
Provided Methods§
sourcefn apply<S, I, F, R>(
self,
service: I,
f: F
) -> AndThen<Self, Apply<S, F, R, Self::Response>>where
Self: Sized,
S: Service,
S::Error: Into<<R::Future as Future>::Error>,
I: IntoService<S>,
F: Fn(Self::Response, &mut S) -> R,
R: IntoFuture<Error = Self::Error>,
fn apply<S, I, F, R>(
self,
service: I,
f: F
) -> AndThen<Self, Apply<S, F, R, Self::Response>>where
Self: Sized,
S: Service,
S::Error: Into<<R::Future as Future>::Error>,
I: IntoService<S>,
F: Fn(Self::Response, &mut S) -> R,
R: IntoFuture<Error = Self::Error>,
Apply function to specified service and use it as a next service in chain.
sourcefn and_then<F, B>(self, service: F) -> AndThen<Self, B>where
Self: Sized,
F: IntoService<B>,
B: Service<Request = Self::Response, Error = Self::Error>,
fn and_then<F, B>(self, service: F) -> AndThen<Self, B>where
Self: Sized,
F: IntoService<B>,
B: Service<Request = Self::Response, Error = Self::Error>,
Call another service after call to this one has resolved successfully.
This function can be used to chain two services together and ensure that the second service isn’t called until call to the fist service have finished. Result of the call to the first service is used as an input parameter for the second service’s call.
Note that this function consumes the receiving service and returns a wrapped version of it.
sourcefn from_err<E>(self) -> FromErr<Self, E>where
Self: Sized,
E: From<Self::Error>,
fn from_err<E>(self) -> FromErr<Self, E>where
Self: Sized,
E: From<Self::Error>,
Map this service’s error to any error implementing From
for
this services
Error`.
Note that this function consumes the receiving service and returns a wrapped version of it.
sourcefn then<B>(self, service: B) -> Then<Self, B>where
Self: Sized,
B: Service<Request = Result<Self::Response, Self::Error>, Error = Self::Error>,
fn then<B>(self, service: B) -> Then<Self, B>where
Self: Sized,
B: Service<Request = Result<Self::Response, Self::Error>, Error = Self::Error>,
Chain on a computation for when a call to the service finished,
passing the result of the call to the next service B
.
Note that this function consumes the receiving future and returns a wrapped version of it.
sourcefn map<F, R>(self, f: F) -> Map<Self, F, R>where
Self: Sized,
F: Fn(Self::Response) -> R,
fn map<F, R>(self, f: F) -> Map<Self, F, R>where
Self: Sized,
F: Fn(Self::Response) -> R,
Map this service’s output to a different type, returning a new service of the resulting type.
This function is similar to the Option::map
or Iterator::map
where
it will change the type of the underlying service.
Note that this function consumes the receiving service and returns a
wrapped version of it, similar to the existing map
methods in the
standard library.
sourcefn map_err<F, E>(self, f: F) -> MapErr<Self, F, E>where
Self: Sized,
F: Fn(Self::Error) -> E,
fn map_err<F, E>(self, f: F) -> MapErr<Self, F, E>where
Self: Sized,
F: Fn(Self::Error) -> E,
Map this service’s error to a different error, returning a new service.
This function is similar to the Result::map_err
where it will change
the error type of the underlying service. This is useful for example to
ensure that services have the same error type.
Note that this function consumes the receiving service and returns a wrapped version of it.