Struct AsyncConnectionPool 

pub struct AsyncConnectionPool<T, F>(/* private fields */);

A tokio-based, cancel-safe connection pool. Cheaply clonable (clones share one pool).

Implementations

impl<T, F> AsyncConnectionPool<T, F>

where T: Clone + Eq + Hash + Send + Sync + 'static, F: AsyncConnectionFactory<T> + 'static,

pub fn new( factory: F, config: PoolConfig, options: Option<PoolOptions<T>>, ) -> Result<Self, PoolError>

Builds an async pool, validating config.

pub fn name(&self) -> &str

The pool’s name.

pub async fn open(&self) -> Result<(), PoolError>

Warms up min_size connections and starts background maintenance. Idempotent.

pub async fn close(&self, timeout: Option<f64>)

Closes idle connections now; checked-out ones close on release. Idempotent. timeout (None = don’t wait) drains gracefully up to that many seconds.

pub fn is_closed(&self) -> bool

Whether close has been called.

pub async fn acquire(&self, timeout: Timeout) -> Result<T, PoolError>

Gets a connection, honoring cancellation (drop the future) and the acquire timeout.

pub async fn release(&self, conn: T) -> Result<(), PoolError>

Returns a connection to the pool for reuse.

pub async fn discard(&self, conn: T) -> Result<(), PoolError>

Returns a connection but forces it to be closed instead of reused.

pub async fn release_with_error( &self, conn: T, error: &(dyn Error + 'static), ) -> Result<(), PoolError>

Returns a connection, signalling the caller’s work raised error.

pub fn stats(&self) -> PoolStats

An immutable snapshot of pool counters and gauges.

pub async fn run_maintenance(&self)

Performs one maintenance sweep (see ConnectionPool::run_maintenance).

Trait Implementations

impl<T, F> Clone for AsyncConnectionPool<T, F>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.