Trait actix_service::ServiceFactory

pub trait ServiceFactory<Req> {
    type Response;
    type Error;
    type Config;
    type Service: Service<Req, Response = Self::Response, Error = Self::Error>;
    type InitError;
    type Future: Future<Output = Result<Self::Service, Self::InitError>>;

    // Required method
    fn new_service(&self, cfg: Self::Config) -> Self::Future;
}

Factory for creating Services.

This is useful for cases where new Services must be produced. One case is a TCP server listener: a listener accepts new connections, constructs a new Service for each using the ServiceFactory trait, and uses the new Service to process inbound requests on that new connection.

Config is a service factory configuration type.

Simple factories may be able to use fn_factory or fn_factory_with_config to reduce boilerplate.

Required Associated Types

type Response

Responses given by the created services.

type Error

Errors produced by the created services.

type Config

Service factory configuration.

type Service: Service<Req, Response = Self::Response, Error = Self::Error>

The kind of Service created by this factory.

type InitError

Errors potentially raised while building a service.

type Future: Future<Output = Result<Self::Service, Self::InitError>>

The future of the Service instance.g

Required Methods

fn new_service(&self, cfg: Self::Config) -> Self::Future

Create and return a new service asynchronously.

Implementations on Foreign Types

impl<S, Req> ServiceFactory<Req> for Rc<S>

where S: ServiceFactory<Req>,

type Response = <S as ServiceFactory<Req>>::Response

type Error = <S as ServiceFactory<Req>>::Error

type Config = <S as ServiceFactory<Req>>::Config

type Service = <S as ServiceFactory<Req>>::Service

type InitError = <S as ServiceFactory<Req>>::InitError

type Future = <S as ServiceFactory<Req>>::Future

fn new_service(&self, cfg: S::Config) -> S::Future

impl<S, Req> ServiceFactory<Req> for Arc<S>

where S: ServiceFactory<Req>,

type Response = <S as ServiceFactory<Req>>::Response

type Error = <S as ServiceFactory<Req>>::Error

type Config = <S as ServiceFactory<Req>>::Config

type Service = <S as ServiceFactory<Req>>::Service

type InitError = <S as ServiceFactory<Req>>::InitError

type Future = <S as ServiceFactory<Req>>::Future

fn new_service(&self, cfg: S::Config) -> S::Future

Implementors

impl<C, Req, Res, Err, InitErr> ServiceFactory<Req> for BoxServiceFactory<C, Req, Res, Err, InitErr>

where Req: 'static, Res: 'static, Err: 'static, InitErr: 'static,

type Response = Res

type Error = Err

type Config = C

type Service = Box<dyn Service<Req, Error = Err, Future = Pin<Box<dyn Future<Output = Result<Res, Err>>>>, Response = Res>>

type InitError = InitErr

type Future = Pin<Box<dyn Future<Output = Result<<BoxServiceFactory<C, Req, Res, Err, InitErr> as ServiceFactory<Req>>::Service, InitErr>>>>

impl<T, S, Req> ServiceFactory<Req> for ApplyTransform<T, S, Req>

where S: ServiceFactory<Req>, T: Transform<S::Service, Req, InitError = S::InitError>,

type Response = <T as Transform<<S as ServiceFactory<Req>>::Service, Req>>::Response

type Error = <T as Transform<<S as ServiceFactory<Req>>::Service, Req>>::Error

type Config = <S as ServiceFactory<Req>>::Config

type Service = <T as Transform<<S as ServiceFactory<Req>>::Service, Req>>::Transform

type InitError = <T as Transform<<S as ServiceFactory<Req>>::Service, Req>>::InitError

type Future = ApplyTransformFuture<T, S, Req>