Struct tower::util::BoxService[][src]

pub struct BoxService<T, U, E> { /* fields omitted */ }
This is supported on crate feature util only.
Expand description

A boxed Service + Send trait object.

BoxService turns a service into a trait object, allowing the response future type to be dynamic. This type requires both the service and the response future to be Send.

See module level documentation for more details.

Implementations

impl<T, U, E> BoxService<T, U, E>[src]

pub fn new<S>(inner: S) -> Self where
    S: Service<T, Response = U, Error = E> + Send + 'static,
    S::Future: Send + 'static, 
[src]

pub fn layer<S>() -> LayerFn<fn(_: S) -> Self> where
    S: Service<T, Response = U, Error = E> + Send + 'static,
    S::Future: Send + 'static, 
[src]

Returns a Layer for wrapping a Service in a BoxService middleware.

Trait Implementations

impl<T, U, E> Debug for BoxService<T, U, E> where
    T: Debug,
    U: Debug,
    E: Debug
[src]

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result[src]

Formats the value using the given formatter. Read more

impl<T, U, E> Service<T> for BoxService<T, U, E>[src]

type Response = U

Responses given by the service.

type Error = E

Errors produced by the service.

type Future = Pin<Box<dyn Future<Output = Result<U, E>> + Send>>

The future response value.

fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll<Result<(), E>>[src]

Returns Poll::Ready(Ok(())) when the service is able to process requests. Read more

fn call(
    &mut self,
    request: T
) -> Pin<Box<dyn Future<Output = Result<U, E>> + Send>>
[src]

Process the request and return the response asynchronously. Read more

Auto Trait Implementations

impl<T, U, E> !RefUnwindSafe for BoxService<T, U, E>

impl<T, U, E> Send for BoxService<T, U, E>

impl<T, U, E> !Sync for BoxService<T, U, E>

impl<T, U, E> Unpin for BoxService<T, U, E>

impl<T, U, E> !UnwindSafe for BoxService<T, U, E>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T> Instrument for T[src]

fn instrument(self, span: Span) -> Instrumented<Self>[src]

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>[src]

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

pub fn into(self) -> U[src]

Performs the conversion.

impl<T, Request> ServiceExt<Request> for T where
    T: Service<Request> + ?Sized
[src]

fn ready(&mut self) -> Ready<'_, Self, Request>

Notable traits for Ready<'a, T, Request>

impl<'a, T, Request> Future for Ready<'a, T, Request> where
    T: Service<Request>, 
type Output = Result<&'a mut T, T::Error>;
where
    Self: Sized
[src]

This is supported on crate feature util only.

Yields a mutable reference to the service when it is ready to accept a request.

fn ready_and(&mut self) -> ReadyAnd<'_, Self, Request> where
    Self: Sized
[src]

👎 Deprecated since 0.4.6:

please use the ServiceExt::ready method instead

This is supported on crate feature 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
[src]

This is supported on crate feature util only.

Yields the service when it is ready to accept a request.

fn oneshot(self, req: Request) -> Oneshot<Self, Request>

Notable traits for Oneshot<S, Req>

impl<S, Req> Future for Oneshot<S, Req> where
    S: Service<Req>, 
type Output = Result<S::Response, S::Error>;
where
    Self: Sized
[src]

This is supported on crate feature util only.

Consume this Service, calling with the providing request once it is ready.

fn call_all<S>(self, reqs: S) -> CallAll<Self, S> where
    Self: Sized,
    Self::Error: Into<BoxError>,
    S: Stream<Item = Request>, 
[src]

This is supported on crate feature util only.

Process all requests from the given Stream, and produce a Stream of their responses. Read more

fn and_then<F>(self, f: F) -> AndThen<Self, F> where
    Self: Sized,
    F: Clone
[src]

This is supported on crate feature 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
[src]

This is supported on crate feature 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

fn map_err<F, Error>(self, f: F) -> MapErr<Self, F> where
    Self: Sized,
    F: FnOnce(Self::Error) -> Error + Clone
[src]

This is supported on crate feature 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

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
[src]

This is supported on crate feature 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
[src]

This is supported on crate feature util only.

Composes a function in front of the service. Read more

fn filter<F, NewRequest>(self, filter: F) -> Filter<Self, F> where
    Self: Sized,
    F: Predicate<NewRequest>, 
[src]

This is supported on crate features util and filter only.

Composes this service with a Filter that conditionally accepts or rejects requests based on a predicate. Read more

fn filter_async<F, NewRequest>(self, filter: F) -> AsyncFilter<Self, F> where
    Self: Sized,
    F: AsyncPredicate<NewRequest>, 
[src]

This is supported on crate features util and filter only.

Composes this service with an AsyncFilter that conditionally accepts or rejects requests based on an [async predicate]. Read more

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>>, 
[src]

This is supported on crate feature util only.

Composes an asynchronous function after this service. Read more

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>>, 
[src]

This is supported on crate feature util only.

Composes a function that transforms futures produced by the service. Read more

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 

pub fn vzip(self) -> V