use futures::{Future, Poll}; use crate::transform_map_err::{TransformMapErr, TransformMapErrNewTransform}; use crate::Service; /// An asynchronous function for transforming service call result. pub trait Transform { /// Requests handled by the service. type Request; /// Responses given by the service. type Response; /// Errors produced by the service. type Error; /// The future response value. type Future: Future; /// Returns `Ready` when the service is able to process requests. /// /// This method is similar to `Service::poll_ready` method. fn poll_ready(&mut self) -> Poll<(), Self::Error>; /// Process the request and apply it to provided service, /// return the response asynchronously. fn call(&mut self, request: Self::Request, service: &mut Service) -> Self::Future; /// Map this transform's error to a different error, returning a new transform. /// /// This function is similar to the `Result::map_err` where it will change /// the error type of the underlying transform. This is useful for example to /// ensure that services and transforms have the same error type. /// /// Note that this function consumes the receiving transform and returns a /// wrapped version of it. fn map_err(self, f: F) -> TransformMapErr where Self: Sized, F: Fn(Self::Error) -> E, { TransformMapErr::new(self, f) } } /// `Transform` service factory pub trait NewTransform { /// Requests handled by the service. type Request; /// Responses given by the service. type Response; /// Errors produced by the service. type Error; /// The `TransformService` value created by this factory type Transform: Transform< Service, Request = Self::Request, Response = Self::Response, Error = Self::Error, >; /// Errors produced while building a service. type InitError; /// The future response value. type Future: Future; /// Create and return a new service value asynchronously. fn new_transform(&self) -> Self::Future; /// Map this transforms's output to a different type, returning a new transform /// of the resulting type. fn map_err(self, f: F) -> TransformMapErrNewTransform where Self: Sized, F: Fn(Self::Error) -> E, { TransformMapErrNewTransform::new(self, f) } } impl<'a, T, S> Transform for &'a mut T where T: Transform + 'a, S: Service, { type Request = T::Request; type Response = T::Response; type Error = T::Error; type Future = T::Future; fn poll_ready(&mut self) -> Poll<(), T::Error> { (**self).poll_ready() } fn call(&mut self, request: Self::Request, service: &mut S) -> T::Future { (**self).call(request, service) } } impl Transform for Box where T: Transform + ?Sized, S: Service, { type Request = T::Request; type Response = T::Response; type Error = T::Error; type Future = T::Future; fn poll_ready(&mut self) -> Poll<(), S::Error> { (**self).poll_ready() } fn call(&mut self, request: Self::Request, service: &mut S) -> T::Future { (**self).call(request, service) } } /// Trait for types that can be converted to a `TransformService` pub trait IntoTransform where T: Transform, { /// Convert to a `TransformService` fn into_transform(self) -> T; } /// Trait for types that can be converted to a TransfromNewService pub trait IntoNewTransform where T: NewTransform, { /// Convert to an `TranformNewService` fn into_new_transform(self) -> T; } impl IntoTransform for T where T: Transform, { fn into_transform(self) -> T { self } } impl IntoNewTransform for T where T: NewTransform, { fn into_new_transform(self) -> T { self } }