Struct ConnectionPool 

pub struct ConnectionPool { /* private fields */ }

Available on crate feature default-client only.

Shared connection topology and pooling policy.

Construct a pool with ConnectionPool::builder, then create Client handles for its anonymous or explicit partitions. The pool itself owns no request placement; each client supplies that partition choice. Cloning a pool or client shares all retained connections and admission state.

A pool built with explicit partitions does not also create an anonymous partition. Dropping the final shared owner logically closes retained connections and stops partition maintenance.

Implementations

impl ConnectionPool

pub fn builder() -> Builder<TlsUnset>

Returns a builder for a new connection pool.

Examples found in repository

examples/custom-dns.rs (line 28)

fn main() {
    let _legacy_client = Builder::new()
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_with_resolver(StaticResolver);

    let pool = ConnectionPool::builder()
        .dns_resolver(StaticResolver)
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_https()
        .expect("valid connection pool");
    let _partitioned_client =
        PoolClient::new(&pool).expect("pool contains the anonymous partition");
}

pub fn origin_stats(&self, origin: &OriginKey) -> OriginConnectionStats

Returns current bounded-capacity accounting for one canonical origin.

The capacity limit applies across every partition. Capacity in use includes establishments, open connections, and detached HTTP/1 upgrades that still own root transport I/O. Ordinary draining connections are excluded after returning their capacity.

Unbounded origins return statistics without a capacity value. The query does not create admission state for an unused origin.

pub fn partition_stats( &self, partition: PartitionId, origin: &OriginKey, ) -> Option<PartitionConnectionStats>

Returns a diagnostic connection snapshot for one partition and origin.

An unknown partition returns None. A configured partition without a retained cell for origin returns zeroed statistics. Cell-owned values are read under the existing cell lock. Counts for lifetimes that can outlive cell records use relaxed atomics and converge after concurrent transitions settle.

Trait Implementations

impl Clone for ConnectionPool

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionPool

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

Formats the value using the given formatter.