Struct ObjectPool 

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

Provides a thread-safe object pool with size limits and object validation.

Implementations

impl<T> ObjectPool<T>

pub const DEFAULT_MAX_SIZE: i32 = 32

The default of the maximum number of objects to keep in the pool.

pub fn new( factory: impl Fn() -> T + Send + Sync + 'static, validator: Option<Box<dyn Fn(&mut T) -> bool + Send + Sync>>, max_size: i32, ) -> Self

Initializes a new instance of the pool.

factory creates new instances. The optional validator cleans and validates an object before it returns to the pool; it returns false to discard the object. max_size is the maximum number of objects to keep in the pool.

Panics when max_size is less than 1.

pub fn rent(&self) -> T

Rents an object from the pool or creates a new one if the pool is empty.

pub fn return_item(&self, item: T)

Returns an object to the pool if it passes validation and the pool is not full.

Callers must not return the same item more than once without an intervening rent. The pool does not detect duplicate returns. The pool also does nothing with the items it drops (when full or when the validator returns false) beyond dropping them; any cleanup belongs in the validator or in the caller.