Struct actix_http::HttpServiceBuilder

pub struct HttpServiceBuilder<T, S, X = ExpectHandler, U = UpgradeHandler<T>> { /* fields omitted */ }

A http service builder

This type can be used to construct an instance of http service through a builder-like pattern.

Methods

impl<T, S> HttpServiceBuilder<T, S, ExpectHandler, UpgradeHandler<T>> where
    S: NewService<Config = SrvConfig, Request = Request>,
    S::Error: Into<Error>,
    S::InitError: Debug, 

pub fn new() -> Self

Create instance of ServiceConfigBuilder

impl<T, S, X, U> HttpServiceBuilder<T, S, X, U> where
    S: NewService<Config = SrvConfig, Request = Request>,
    S::Error: Into<Error>,
    S::InitError: Debug,
    X: NewService<Config = SrvConfig, Request = Request, Response = Request>,
    X::Error: Into<Error>,
    X::InitError: Debug,
    U: NewService<Config = SrvConfig, Request = (Request, Framed<T, Codec>), Response = ()>,
    U::Error: Display,
    U::InitError: Debug, 

pub fn keep_alive<W: Into<KeepAlive>>(self, val: W) -> Self

Set server keep-alive setting.

By default keep alive is set to a 5 seconds.

pub fn client_timeout(self, val: u64) -> Self

Set server client timeout in milliseconds for first request.

Defines a timeout for reading client request header. If a client does not transmit the entire set headers within this time, the request is terminated with the 408 (Request Time-out) error.

To disable timeout set value to 0.

By default client timeout is set to 5000 milliseconds.

pub fn client_disconnect(self, val: u64) -> Self

Set server connection disconnect timeout in milliseconds.

Defines a timeout for disconnect connection. If a disconnect procedure does not complete within this time, the request get dropped. This timeout affects secure connections.

To disable timeout set value to 0.

By default disconnect timeout is set to 0.

pub fn expect<F, X1>(self, expect: F) -> HttpServiceBuilder<T, S, X1, U> where
    F: IntoNewService<X1>,
    X1: NewService<Config = SrvConfig, Request = Request, Response = Request>,
    X1::Error: Into<Error>,
    X1::InitError: Debug, 

Provide service for EXPECT: 100-Continue support.

Service get called with request that contains EXPECT header. Service must return request in case of success, in that case request will be forwarded to main service.

pub fn upgrade<F, U1>(self, upgrade: F) -> HttpServiceBuilder<T, S, X, U1> where
    F: IntoNewService<U1>,
    U1: NewService<Config = SrvConfig, Request = (Request, Framed<T, Codec>), Response = ()>,
    U1::Error: Display,
    U1::InitError: Debug, 

Provide service for custom Connection: UPGRADE support.

If service is provided then normal requests handling get halted and this service get called with original request and framed object.

pub fn on_connect<F, I>(self, f: F) -> Self where
    F: Fn(&T) -> I + 'static,
    I: Clone + 'static, 

Set on-connect callback.

It get called once per connection and result of the call get stored to the request's extensions.

pub fn h1<F, P, B>(self, service: F) -> H1Service<T, P, S, B, X, U> where
    B: MessageBody + 'static,
    F: IntoNewService<S>,
    S::Error: Into<Error>,
    S::InitError: Debug,
    S::Response: Into<Response<B>>, 

Finish service configuration and create http service for HTTP/1 protocol.

pub fn h2<F, P, B>(self, service: F) -> H2Service<T, P, S, B> where
    B: MessageBody + 'static,
    F: IntoNewService<S>,
    S::Error: Into<Error>,
    S::InitError: Debug,
    S::Response: Into<Response<B>>,
    <S::Service as Service>::Future: 'static, 

Finish service configuration and create http service for HTTP/2 protocol.

pub fn finish<F, P, B>(self, service: F) -> HttpService<T, P, S, B, X, U> where
    B: MessageBody + 'static,
    F: IntoNewService<S>,
    S::Error: Into<Error>,
    S::InitError: Debug,
    S::Response: Into<Response<B>>,
    <S::Service as Service>::Future: 'static, 

Finish service configuration and create HttpService instance.