Struct HttpClientFactory 

pub struct HttpClientFactory { /* private fields */ }

Builds route-specific HTTP clients using one resolved outbound proxy policy.

Construct this once from the effective application configuration and carry it with the session or component that owns outbound requests. Individual request paths should supply only their destination and route class rather than resolving feature state themselves.

Implementations

impl HttpClientFactory

pub fn build_client( &self, request_url: &str, route_class: ClientRouteClass, ) -> Result<HttpClient, BuildRouteAwareHttpClientError>

Builds an HTTP client for one fixed destination using the configured proxy policy.

This is the preferred construction path for product traffic that uses a fixed destination. Use crate::RouteAwareClientPool instead when request or redirect URLs can vary.

pub fn build_client_without_request_logging( &self, request_url: &str, route_class: ClientRouteClass, ) -> Result<HttpClient, BuildRouteAwareHttpClientError>

Builds a policy-aware client without request URL or response-header diagnostics.

This has the same routing guidance as Self::build_client.

impl HttpClientFactory

pub const fn new(outbound_proxy_policy: OutboundProxyPolicy) -> Self

Creates a factory from the outbound proxy policy resolved by the application.

pub const fn outbound_proxy_policy(&self) -> OutboundProxyPolicy

Returns the outbound proxy policy used for clients built by this factory.

pub fn resolve_proxy_route(&self, request_url: &str) -> OutboundProxyRoute

Resolves the proxy route for a concrete destination.

WebSocket schemes are resolved through their HTTP equivalents so platform PAC and system proxy APIs apply the same policy to ws/wss and http/https destinations. When system resolution is unavailable, explicit environment settings are resolved before falling back to a direct route.

pub async fn resolve_proxy_route_async( &self, request_url: String, ) -> Result<OutboundProxyRoute>

Resolves the proxy route for a concrete destination without blocking a Tokio worker.

pub fn build_reqwest_client( &self, builder: ClientBuilder, request_url: &str, route_class: ClientRouteClass, ) -> Result<Client, BuildRouteAwareHttpClientError>

Builds a reqwest client for a concrete outbound route.

Trait Implementations

impl Clone for HttpClientFactory

fn clone(&self) -> HttpClientFactory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpClientFactory

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

Formats the value using the given formatter.

impl Eq for HttpClientFactory

impl PartialEq for HttpClientFactory

fn eq(&self, other: &HttpClientFactory) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HttpClientFactory