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>>;
    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.

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

Loading content...

Required methods

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

Create and return a new service asynchronously.

Loading content...

Implementations on Foreign Types

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

type Response = S::Response

type Error = S::Error

type Config = S::Config

type Service = S::Service

type InitError = S::InitError

type Future = S::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::Response

type Error = S::Error

type Config = S::Config

type Service = S::Service

type InitError = S::InitError

type Future = S::Future

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

Loading content...

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 = BoxService<Req, Res, Err>

type InitError = InitErr

type Future = BoxFuture<Result<Self::Service, InitErr>>

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

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::Response

type Error = T::Error

type Config = S::Config

type Service = T::Transform

type InitError = T::InitError

type Future = ApplyTransformFuture<T, S, Req>

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

Loading content...