use std::fmt; use std::marker::PhantomData; use actix_codec::Framed; use actix_server_config::ServerConfig as SrvConfig; use actix_service::{IntoNewService, NewService, Service}; use crate::body::MessageBody; use crate::config::{KeepAlive, ServiceConfig}; use crate::error::Error; use crate::h1::{Codec, ExpectHandler, H1Service, UpgradeHandler}; use crate::h2::H2Service; use crate::request::Request; use crate::response::Response; use crate::service::HttpService; /// A http service builder /// /// This type can be used to construct an instance of `http service` through a /// builder-like pattern. pub struct HttpServiceBuilder> { keep_alive: KeepAlive, client_timeout: u64, client_disconnect: u64, expect: X, upgrade: Option, _t: PhantomData<(T, S)>, } impl HttpServiceBuilder> where S: NewService, S::Error: Into, S::InitError: fmt::Debug, { /// Create instance of `ServiceConfigBuilder` pub fn new() -> Self { HttpServiceBuilder { keep_alive: KeepAlive::Timeout(5), client_timeout: 5000, client_disconnect: 0, expect: ExpectHandler, upgrade: None, _t: PhantomData, } } } impl HttpServiceBuilder where S: NewService, S::Error: Into, S::InitError: fmt::Debug, X: NewService, X::Error: Into, X::InitError: fmt::Debug, U: NewService), Response = ()>, U::Error: fmt::Display, U::InitError: fmt::Debug, { /// Set server keep-alive setting. /// /// By default keep alive is set to a 5 seconds. pub fn keep_alive>(mut self, val: W) -> Self { self.keep_alive = val.into(); 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_timeout(mut self, val: u64) -> Self { self.client_timeout = val; 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 client_disconnect(mut self, val: u64) -> Self { self.client_disconnect = val; self } /// 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 expect(self, expect: F) -> HttpServiceBuilder where F: IntoNewService, X1: NewService, X1::Error: Into, X1::InitError: fmt::Debug, { HttpServiceBuilder { keep_alive: self.keep_alive, client_timeout: self.client_timeout, client_disconnect: self.client_disconnect, expect: expect.into_new_service(), upgrade: self.upgrade, _t: PhantomData, } } /// 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 upgrade(self, upgrade: F) -> HttpServiceBuilder where F: IntoNewService, U1: NewService), Response = ()>, U1::Error: fmt::Display, U1::InitError: fmt::Debug, { HttpServiceBuilder { keep_alive: self.keep_alive, client_timeout: self.client_timeout, client_disconnect: self.client_disconnect, expect: self.expect, upgrade: Some(upgrade.into_new_service()), _t: PhantomData, } } /// Finish service configuration and create *http service* for HTTP/1 protocol. pub fn h1(self, service: F) -> H1Service where B: MessageBody + 'static, F: IntoNewService, S::Error: Into, S::InitError: fmt::Debug, S::Response: Into>, { let cfg = ServiceConfig::new( self.keep_alive, self.client_timeout, self.client_disconnect, ); H1Service::with_config(cfg, service.into_new_service()) .expect(self.expect) .upgrade(self.upgrade) } /// Finish service configuration and create *http service* for HTTP/2 protocol. pub fn h2(self, service: F) -> H2Service where B: MessageBody + 'static, F: IntoNewService, S::Error: Into, S::InitError: fmt::Debug, S::Response: Into>, ::Future: 'static, { let cfg = ServiceConfig::new( self.keep_alive, self.client_timeout, self.client_disconnect, ); H2Service::with_config(cfg, service.into_new_service()) } /// Finish service configuration and create `HttpService` instance. pub fn finish(self, service: F) -> HttpService where B: MessageBody + 'static, F: IntoNewService, S::Error: Into, S::InitError: fmt::Debug, S::Response: Into>, ::Future: 'static, { let cfg = ServiceConfig::new( self.keep_alive, self.client_timeout, self.client_disconnect, ); HttpService::with_config(cfg, service.into_new_service()) .expect(self.expect) .upgrade(self.upgrade) } }