Struct ConnectionCache 

pub struct ConnectionCache<C> { /* private fields */ }

Thread-safe connection cache bound to exact host topology revisions.

The cache does not open or close connections. Drivers own those lifecycle actions and receive removed handles from invalidation and eviction methods.

Implementations

impl<C> ConnectionCache<C>

pub fn new() -> Self

Creates an empty cache.

pub fn insert(&self, host: &HostRecord, connection: C) -> Option<Arc<C>>

Inserts a connection for one exact host revision.

Returns the replaced handle when the same key already existed.

pub fn get(&self, host: &HostRecord) -> Option<Arc<C>>

Returns a connection only when the host revision matches exactly.

pub fn remove(&self, host: &HostRecord) -> Option<Arc<C>>

Removes one exact host revision.

pub fn invalidate_host(&self, host: &HostId) -> Vec<Arc<C>>

Removes every cached revision for one host.

pub fn retain_snapshot(&self, snapshot: &TopologySnapshot) -> Vec<Arc<C>>

Removes keys absent from the supplied topology snapshot.

A host whose endpoint changed has a new revision and therefore evicts the old cached connection even when its stable host identity is unchanged.

pub fn len(&self) -> usize

Returns the number of cached revision keys.

pub fn is_empty(&self) -> bool

Returns whether the cache has no entries.

pub fn keys(&self) -> Vec<PoolKey>

Returns sorted cached keys for metrics or diagnostics.

Trait Implementations

impl<C> Default for ConnectionCache<C>

fn default() -> Self

Returns the “default value” for a type.