Struct ConnectionPool 

pub struct ConnectionPool { /* private fields */ }

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.

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) -> ConnectionPool

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.