Struct ReplicaPool 

pub struct ReplicaPool { /* private fields */ }

Multi-Database Read Replica Load Balancer. Transparently load-balances read queries across secondary replicas while sending write queries to the primary database.

Implementations

impl ReplicaPool

pub fn new(primary: RullstPool, replicas: Vec<RullstPool>) -> Self

Creates a new ReplicaPool with a primary pool and a list of read replica pools.

pub fn primary_only(primary: RullstPool) -> Self

Creates a ReplicaPool with only a primary pool (no read replicas).

pub fn read(&self) -> &RullstPool

Returns a pool reference for read queries using Round-Robin balancing across replicas. Falls back to the primary pool if no replicas are available.

pub fn write(&self) -> &RullstPool

Returns a pool reference to the primary database for write/mutation operations.

pub fn replica_count(&self) -> usize

Returns the number of active read replicas configured.