Struct ResourcePool 

pub struct ResourcePool<T> { /* private fields */ }

A resource pool that manages the lifecycle of expensive resources

This pool provides thread-safe access to resources with automatic cleanup, health checking, and graceful degradation.

Implementations

impl<T> ResourcePool<T>

where T: Send + 'static,

pub fn new<F>( config: PoolConfig, factory: F, ) -> Result<Self, Box<dyn Error + Send + Sync>>

where F: Fn() -> Result<T, Box<dyn Error + Send + Sync>> + Send + Sync + 'static,

Create a new resource pool

Arguments

• config: Pool configuration
• factory: Function to create new resources

Example

use foundation_utils::resource::{ResourcePool, PoolConfig};

let pool = ResourcePool::new(
    PoolConfig::default(),
    || Ok("new_resource".to_string())
).unwrap();

pub fn with_health_checker<F>(self, health_checker: F) -> Self

where F: Fn(&T) -> bool + Send + Sync + 'static,

Set a health checker function for resources

The health checker is called periodically to validate that pooled resources are still healthy.

pub fn acquire(&self) -> Result<ResourceGuard<T>, Box<dyn Error + Send + Sync>>

Acquire a resource from the pool

This method will either return an existing resource from the pool or create a new one if the pool is not at capacity.

Returns

A ResourceGuard that automatically returns the resource to the pool when dropped.

pub fn stats(&self) -> PoolStats

Get pool statistics

pub fn health_check(&self) -> Result<usize, Box<dyn Error + Send + Sync>>

Perform health check on all idle resources