Struct AqlClientBuilder 

pub struct AqlClientBuilder { /* private fields */ }

Builder for AQL client with fluent configuration

Implementations

impl AqlClientBuilder

pub fn new() -> Self

Create a new builder

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

Set connection timeout

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

Set request timeout

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

Enable or disable keep-alive

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

Set keep-alive interval

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

Set minimum pool size

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

Set maximum pool size

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

Set idle timeout

pub fn max_lifetime(self, lifetime: Duration) -> Self

Set max connection lifetime

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

Set health check interval

pub fn balancing_strategy(self, strategy: BalancingStrategy) -> Self

Set load balancing strategy

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

Enable or disable circuit breaker

pub fn with_retry(self, retry_config: RetryConfig) -> Self

Configure retry logic

pub fn with_compression(self, compression_config: CompressionConfig) -> Self

Configure compression

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

Set request timeout (alias for builder fluency)

pub fn with_tls_config(self, tls_config: TlsClientConfig) -> Self

Set a full TLS configuration for the client

Configures the client to use TLS for all connections using the provided TlsClientConfig.

pub fn with_ca_cert(self, ca_cert_path: impl Into<PathBuf>) -> Self

Enable TLS with a CA certificate for server verification

The client will verify the server’s certificate against the provided CA certificate. Connections use https://.

pub fn with_mtls( self, cert_path: impl Into<PathBuf>, key_path: impl Into<PathBuf>, ) -> Self

Enable mutual TLS (mTLS) with client certificate and key

The client presents its certificate to the server for mutual authentication. Both the client cert and key must be PEM-encoded.

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

Set the TLS domain name override

Overrides the domain name used for server certificate verification. Useful when connecting to servers via IP address or non-standard hostnames.

pub fn with_tls_skip_verification(self) -> Self

Enable TLS with skip verification (development/testing only)

WARNING: This disables server certificate verification. Never use in production.

pub fn add_endpoint(self, id: String, address: String) -> Self

Add an endpoint

pub fn add_endpoint_with_weight( self, id: String, address: String, weight: u32, ) -> Self

Add an endpoint with weight

pub fn build(self) -> NetResult<AqlClient>

Build the client

Errors

Returns NetError::TlsError if TLS is configured but the configuration is invalid (e.g., cert without key) or certificate files cannot be read.

Trait Implementations

impl Default for AqlClientBuilder

fn default() -> Self

Returns the “default value” for a type.