Struct PreparedStatementCache 

pub struct PreparedStatementCache { /* private fields */ }

Thread-safe cache for prepared statements with LRU eviction

Implementations

impl PreparedStatementCache

pub fn new(max_size: usize) -> Self

Create a new cache with specified max size

pub fn default_cache() -> Self

Create a default cache (1000 entries)

pub fn get(&self, sql: &str) -> Option<Arc<PreparedStatement>>

Get a prepared statement from cache (updates LRU order)

pub fn get_or_prepare( &self, sql: &str, ) -> Result<Arc<PreparedStatement>, PreparedStatementError>

Get or insert a prepared statement

If the SQL is in cache, returns the cached statement. Otherwise, parses the SQL, caches it, and returns the new statement. Uses double-checked locking to avoid duplicate parsing.

pub fn get_or_prepare_arena( &self, sql: &str, ) -> Result<Arc<ArenaPreparedStatement>, ArenaParseError>

Get or insert an arena-based prepared statement

This method returns an arena-allocated SELECT statement for optimal performance. It’s only for SELECT statements - other statement types will fail with UnsupportedStatement.

Arena statements provide:

• Better cache locality (contiguous memory)
• Potentially lower allocation overhead
• Direct use with arena-based execution paths

For non-SELECT statements, use get_or_prepare instead.

pub fn get_arena(&self, sql: &str) -> Option<Arc<ArenaPreparedStatement>>

Get an arena-based prepared statement if it exists in cache

pub fn clear(&self)

Clear all cached statements (both owned and arena)

pub fn invalidate_table(&self, table: &str)

Invalidate all statements referencing a table

pub fn stats(&self) -> PreparedStatementCacheStats

Get cache statistics

pub fn max_size(&self) -> usize

Get maximum cache size