Struct ClientBuilder 

pub struct ClientBuilder(/* private fields */);

Manages http client network connectivity.

The ClientBuilder type uses a builder-like combinator pattern for service construction that finishes by calling the .finish() method.

Implementations

impl ClientBuilder

pub fn with_default<A, U>(addr: U) -> Self

where A: Address + Clone, Connect<A>: From<U>,

impl ClientBuilder

pub fn scheme(self, scheme: Scheme) -> Self

Set client’s connection scheme

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.

pub fn max_streams(self, limit: u32) -> Self

Set total number of simultaneous streams per connection.

If limit is 0, the connector uses “MAX_CONCURRENT_STREAMS” config from connection settings. The default limit size is 100.

pub fn skip_unknown_streams(self) -> Self

Do not return error for frames for unknown streams.

This includes pending resets, data and window update frames.

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 not set.

pub fn minconn(self, num: usize) -> Self

Sets the minimum concurrent connections.

By default min connections is set to a 1.

pub fn maxconn(self, num: usize) -> Self

Sets the maximum concurrent connections.

By default max connections is set to a 16.

pub fn disconnect_timeout<T: Into<Millis>>(self, timeout: T) -> Self

Set client connection disconnect timeout.

Defines a timeout for disconnect connection. Disconnecting connection involes closing all active streams. If a disconnect procedure does not complete within this time, the socket get dropped.

To disable timeout set value to 0.

By default disconnect timeout is set to 15 seconds.

pub fn configure<O, R>(self, f: O) -> Self

where O: FnOnce(&Config) -> R,

Configure http2 connection settings

pub fn config(&self) -> &Config

Http/2 connection settings

pub fn connector<A, U, T, F>(self, addr: U, connector: F) -> Self

where A: Address + Clone, F: IntoService<T, Connect<A>>, T: Service<Connect<A>, Error = ConnectError> + 'static, IoBoxed: From<T::Response>, Connect<A>: From<U>,

Use custom connector

pub fn finish(self) -> Client

Finish configuration process and create connections pool.

Trait Implementations

impl Debug for ClientBuilder

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

Formats the value using the given formatter.