pub struct Connector { /* private fields */ }
Expand description
Manages http client network connectivity.
The Connector
type uses a builder-like combinator pattern for service
construction that finishes by calling the .finish()
method.
use ntex::http::client::Connector;
use ntex::time::Millis;
let connector = Connector::default()
.timeout(Millis(5_000))
.finish();
Implementations§
source§impl Connector
impl Connector
sourcepub fn timeout<T: Into<Millis>>(self, timeout: T) -> Self
pub fn timeout<T: Into<Millis>>(self, timeout: T) -> Self
Connection timeout.
i.e. max time to connect to remote host including dns name resolution. Set to 1 second by default.
sourcepub fn openssl(self, connector: OpensslConnector) -> Self
pub fn openssl(self, connector: OpensslConnector) -> Self
Use openssl connector for secured connections.
sourcepub fn rustls(self, connector: ClientConfig) -> Self
pub fn rustls(self, connector: ClientConfig) -> Self
Use rustls connector for secured connections.
sourcepub fn limit(self, limit: usize) -> Self
pub fn limit(self, limit: usize) -> Self
Set total number of simultaneous connections per type of scheme.
If limit is 0, the connector has no limit. The default limit size is 100.
sourcepub fn keep_alive(self, dur: Seconds) -> Self
pub fn keep_alive(self, dur: Seconds) -> Self
Set keep-alive period for opened connection.
Keep-alive period is the period between connection usage. If the delay between repeated usages of the same connection exceeds this period, the connection is closed. Default keep-alive period is 15 seconds.
sourcepub fn lifetime(self, dur: Seconds) -> Self
pub fn lifetime(self, dur: Seconds) -> Self
Set max lifetime period for connection.
Connection lifetime is max lifetime of any opened connection until it is closed regardless of keep-alive period. Default lifetime period is 75 seconds.
sourcepub fn disconnect_timeout<T: Into<Seconds>>(self, timeout: T) -> Self
pub fn disconnect_timeout<T: Into<Seconds>>(self, timeout: T) -> Self
Set server connection disconnect timeout.
Defines a timeout for disconnect connection. If a disconnect procedure does not complete within this time, the socket get dropped. This timeout affects only secure connections.
To disable timeout set value to 0.
By default disconnect timeout is set to 3 seconds.
sourcepub fn connector<T>(self, connector: T) -> Self
pub fn connector<T>(self, connector: T) -> Self
Use custom connector to open un-secured connections.
sourcepub fn secure_connector<T>(self, connector: T) -> Self
pub fn secure_connector<T>(self, connector: T) -> Self
Use custom connector to open secure connections.