Struct HttpClientBuilder 

pub struct HttpClientBuilder { /* private fields */ }

Available on crate feature client only.

Builder for HttpClient connector-level options.

Use HttpClient::builder to obtain one. The terminal methods mirror the associated constructors on HttpClient; the existing constructors delegate here, so HttpClient::plaintext() is exactly HttpClient::builder().plaintext().

Implementations

impl HttpClientBuilder

pub fn connect_timeout(self, dur: Duration) -> Self

Bound the TCP connect phase.

This is hyper’s HttpConnector::set_connect_timeout, applied to the inner connector for all three transport flavours. It covers only the TCP connect(2) call (per resolved address — hyper divides the timeout evenly across the address set). It does not cover DNS resolution or, for with_tls, the TLS handshake. Use a per-request timeout (e.g. CallOptions::with_timeout) to bound DNS+connect+TLS+request as a whole.

Unset (the default) means no explicit bound: TCP connect is governed by the kernel’s tcp_syn_retries (typically ~130s on Linux). Set this when the network path can silently drop SYNs and you’d rather fail fast than stall on kernel retransmits.

pub fn plaintext(self) -> HttpClient

Finish building as a plaintext client. See HttpClient::plaintext.

pub fn plaintext_http2_only(self) -> HttpClient

Finish building as an h2c-only plaintext client. See HttpClient::plaintext_http2_only.

pub fn with_tls(self, tls_config: Arc<ClientConfig>) -> HttpClient

Available on crate feature client-tls only.

Finish building as a TLS client. See HttpClient::with_tls.

Trait Implementations

impl Clone for HttpClientBuilder

fn clone(&self) -> HttpClientBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClientBuilder

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

Formats the value using the given formatter.

impl Default for HttpClientBuilder

fn default() -> HttpClientBuilder

Returns the “default value” for a type.