Struct GenericPool

pub struct GenericPool<T: Poolable + Clone> { /* private fields */ }

Generic high-performance object pool optimized for HFT latency requirements

Provides sub-microsecond object borrowing/returning through pre-allocation and recycling. Uses parking_lot::RwLock for thread safety with read-optimized concurrency patterns.

Design Trade-offs

• RwLock vs Lock-free: RwLock chosen for simplicity and good read concurrency
• SmallVec optimization: Stack allocation for small pools, heap expansion when needed
• Generic constraints: Poolable + Clone ensures safe reuse patterns
• Statistics tracking: Built-in monitoring with nanosecond-precision timing

Performance Profile

• Borrow latency: 5-20ns typical (RwLock read + SmallVec pop)
• Return latency: 10-30ns typical (reset + RwLock write + SmallVec push)
• Concurrency: Multiple concurrent borrowers, serialized returns
• Memory footprint: Configurable capacity with pre-allocation

Implementations

impl<T: Poolable + Clone> GenericPool<T>

pub fn new() -> Self

Create a new object pool with default capacity

pub fn with_capacity(capacity: usize) -> Self

Create a new object pool with specified capacity

pub fn borrow(&self) -> T

Borrow an object from the pool

Returns a pre-allocated object that can be configured for use. If pool is empty, allocates a new object (tracked in stats).

pub fn return_object(&self, object: T)

Return an object to the pool for reuse

The object will be available for future borrowing. If pool is full, the object is dropped (no memory leak).

pub fn stats(&self) -> PoolStats

Get current pool statistics

pub fn reset_stats(&self)

Reset pool statistics

pub fn warmup(&self, iterations: usize)

Warm up the pool by pre-borrowing and returning objects

This helps establish optimal memory layout and cache patterns.

Trait Implementations

impl<T: Debug + Poolable + Clone> Debug for GenericPool<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Poolable + Clone> Default for GenericPool<T>

fn default() -> Self

Returns the “default value” for a type.