Struct HttpService 

pub struct HttpService<F, Req: RequestState<Io<F>>, Err> { /* private fields */ }

An HTTP/1.1 and HTTP/2 transport service.

The protocol is selected from HttpProtocol metadata attached to the I/O stream, normally by a TLS ALPN acceptor. Connections without HTTP/2 metadata are handled as HTTP/1.

Implementations

impl<F, Req, Err> HttpService<F, Req, Err>

where F: Filter + 'static, Req: RequestState<Io<F>>, Req::State: Clone, Err: ResponseError + 'static,

pub fn new<H>(sf: impl IntoServiceFactory<H, Req::State, Request>) -> Self

where H: ServiceFactory<Req::State, Request, Error = Err> + 'static, H::Res: Into<Response>, H::InitError: IntoFailure,

Creates a service that supports HTTP/1.1 and HTTP/2.

pub fn h1<H>( sf: impl IntoServiceFactory<H, Req::State, Request>, ) -> H1Service<F, Req, Err>

where H: ServiceFactory<Req::State, Request, Error = Err> + 'static, H::Res: Into<Response>, H::InitError: IntoFailure,

Creates an HTTP/1-only service.

pub fn h2<H>( sf: impl IntoServiceFactory<H, Req::State, Request>, ) -> H2Service<F, Req, Err>

where H: ServiceFactory<Req::State, Request, Error = Err> + 'static, H::Res: Into<Response>, H::InitError: IntoFailure,

Creates an HTTP/2-only service.

impl<F, Req, Err> HttpService<F, Req, Err>

where F: Filter, Req: RequestState<Io<F>>, Err: ResponseError + 'static,

pub fn h1_control<Ctl>( self, ctl: impl IntoServiceFactory<Ctl, Req::State, Control<F, Err>>, ) -> Self

where Ctl: ServiceFactory<Req::State, Control<F, Err>, Res = ControlAck<F>> + 'static, Ctl::Error: IntoFailure, Ctl::InitError: IntoFailure,

Provides the HTTP/1 control service.

The service receives the lifecycle events described by h1::Control. Unless this method is called, the default action is applied to each event without a service call.

pub fn h2_control<Ctl>( self, ctl: impl IntoServiceFactory<Ctl, Req::State, Control<Error<H2Error>>>, ) -> Self

where Ctl: ServiceFactory<Req::State, Control<Error<H2Error>>, Res = ControlAck> + 'static, Ctl::Error: IntoFailure, Ctl::InitError: IntoFailure,

Provides the HTTP/2 control service.

A default service that acknowledges each HTTP/2 control event is used unless this method is called.

Trait Implementations

impl<F, Req: RequestState<Io<F>>, Err> Debug for HttpService<F, Req, Err>

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

Formats the value using the given formatter.

impl<St, F, Req, Err> Service<St, Req> for HttpService<F, Req, Err>

where F: Filter + 'static, Req: RequestState<Io<F>>, Req::State: Clone, Err: ResponseError + 'static,

type Res = ()

Response produced by the service.

type Error = DispatchError

Error produced while checking readiness or processing a request.

async fn call( &self, req: Req, _: Ctx<'_, Self, St>, ) -> Result<Self::Res, Self::Error>

Processes a request and asynchronously returns the response.

async fn ready(&self, _: Ctx<'_, Self, St>) -> Result<(), Self::Error>

Waits until the service is ready to process a request.

async fn shutdown(&self, _: Ctx<'_, Self, St>)

Shuts down the service.

fn map<F, Res>(self, f: F) -> ServiceChain<Map<F, Self, Res>, St, Req>

where Self: Sized, F: Fn(Self::Res) -> Res,

Maps this service’s output to a different type, returning a new service.

fn map_err<F, E>(self, f: F) -> ServiceChain<MapErr<F, Self, E>, St, Req>

where Self: Sized, F: Fn(Self::Error) -> E,

Maps this service’s error to a different type, returning a new service.

fn and_then<Next, F>(self, f: F) -> ServiceChain<AndThen<Self, Next>, St, Req>

where Self: Sized, Next: Service<St, Self::Res, Error = Self::Error>, F: IntoService<Next, St, Self::Res>,

Calls another service after this service completes successfully.

fn pipeline(self, st: St) -> Pipeline<Req, Self::Res, Self::Error>

where Self: Sized + 'static, St: 'static, Req: 'static,

Wraps this service and its state in a Pipeline.