Struct HttpClientBuilder 

pub struct HttpClientBuilder { /* private fields */ }

Builder for HttpClient.

This provides a reqwest-style fluent API for configuring the high-level HTTP client and its underlying connection pool defaults.

Implementations

impl HttpClientBuilder

pub fn new() -> Self

Creates a builder with default configuration.

pub fn pool_config(self, pool_config: PoolConfig) -> Self

Replaces the full pool configuration.

pub fn max_connections_per_host(self, max: usize) -> Self

Sets max pooled connections per host.

pub fn max_total_connections(self, max: usize) -> Self

Sets max pooled connections across all hosts.

pub fn idle_timeout(self, timeout: Duration) -> Self

Sets idle timeout for pooled connections.

pub fn cleanup_interval(self, interval: Duration) -> Self

Sets cleanup interval for idle pooled connections.

pub fn request_timeout(self, timeout: Duration) -> Self

Sets the default total request timeout (br-asupersync-server-stack-hardening-eeexl1.1.3).

Meet-composed with the remaining ambient budget and any per-call override; the tightest bound wins (see HttpClientConfig::request_timeout).

pub fn redirect_policy(self, policy: RedirectPolicy) -> Self

Sets redirect behavior.

pub fn max_redirects(self, max: u32) -> Self

Follows up to max redirects.

pub fn same_origin_redirects(self, max: u32) -> Self

Follows redirects only when the target has the same scheme, host, and port as the original request.

pub fn no_redirects(self) -> Self

Disables automatic redirect following.

pub fn retry_policy(self, policy: RetryPolicy) -> Self

Sets automatic retry behavior.

pub fn retry_safe_methods_on_stale_reuse(self) -> Self

Retries safe methods once when a reused pooled connection is stale.

pub fn retry_idempotent_statuses(self, max_retries: u32) -> Self

Retries idempotent methods on retryable response status codes.

Valid Retry-After delta-seconds response headers are honored before retrying. Use Self::no_retries when no automatic retry behavior is desired.

pub fn no_retries(self) -> Self

Disables all automatic retries.

pub fn user_agent(self, user_agent: impl Into<String>) -> Self

Sets default User-Agent.

pub fn no_user_agent(self) -> Self

Removes default User-Agent.

pub fn default_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Adds a default header to every request unless that request supplies the same header name.

pub fn default_headers<I, N, V>(self, headers: I) -> Self

where I: IntoIterator<Item = (N, V)>, N: Into<String>, V: Into<String>,

Adds multiple default headers.

pub fn cookie_store(self, enabled: bool) -> Self

Enables/disables automatic cookie persistence and attachment.

pub fn no_cookie_store(self) -> Self

Disables automatic cookie persistence and attachment.

pub fn max_body_size(self, size: usize) -> Self

Sets the maximum response body size in bytes.

By default, the HTTP/1.1 codec limits responses to 16 MiB. Use this to raise the limit when downloading large files.

Example

let client = HttpClient::builder()
    .max_body_size(500 * 1024 * 1024) // 500 MB
    .build();

pub fn proxy(self, proxy_url: impl Into<String>) -> Self

Routes requests through a proxy endpoint.

Supported URL schemes: http://, https://, and socks5://.

pub fn no_proxy(self) -> Self

Disables proxy routing.

pub fn with_time_getter(self, time_getter: fn() -> Time) -> Self

Sets a custom time source for deterministic pool timestamps.

pub fn build(self) -> HttpClient

Builds the HttpClient.

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.