Struct Pool 

pub struct Pool { /* private fields */ }

A fixed-size HTTP connection pool with round-robin dispatch.

Implementations

impl Pool

pub fn new(config: PoolConfig) -> Self

Create a new pool. All slots start disconnected.

pub async fn connect_all(&mut self) -> Result<(), HttpError>

Eagerly connect all slots.

pub async fn client(&mut self) -> Result<PooledClient<'_>, HttpError>

Get a client bound to the next healthy connection.

Advances the round-robin cursor. Disconnected slots are lazily reconnected. Returns HttpError::AllConnectionsFailed if all slots fail.

The returned PooledClient derefs to &mut HttpClient and, on drop, recycles its slot if the peer signalled close (HttpClient::peer_will_close). The next call to client() will lazily reconnect that slot.

pub fn mark_disconnected(&mut self, idx: usize)

Mark a slot as disconnected by index, closing the underlying connection.

pub fn close_all(&mut self)

Close all connections.

pub fn connected_count(&self) -> usize

Number of currently connected slots.

pub fn pool_size(&self) -> usize

Total number of slots in the pool.