Struct QueryCache 

pub struct QueryCache<B = ()> { /* private fields */ }

Query cache for parsed SQL statements

Provides thread-safe caching of parsed SQL queries to avoid the overhead of parsing the same query multiple times.

Implementations

impl<B: Default> QueryCache<B>

pub fn new(max_size: usize) -> Self

Create a new query cache with the given maximum size

pub fn default_sized() -> Self

Create a new query cache with default size

pub fn get(&self, query: &str) -> Option<CachedPlanRef<B>>

Get a cached plan for a query if available

Returns a cheap Arc clone of the cached statement and metadata. The Statement is immutable and shared via Arc.

A hit updates recency and usage so eviction reflects actual access.

pub fn put( &self, query: &str, statement: Arc<Statement>, _has_params: bool, _param_count: usize, ) -> CachedPlanRef<B>

Add a plan to the cache

Returns a lightweight reference to the cached plan (CachedPlanRef). This avoids cloning SmartStrings since callers only need the statement and compiled execution state.

pub fn clear(&self)

Clear the cache

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

Invalidate all cached plans that reference a specific table Called after DDL operations (ALTER TABLE, DROP TABLE, etc.)

pub fn size(&self) -> usize

Get the number of plans in the cache

pub fn stats(&self) -> CacheStats

Get cache statistics

Trait Implementations

impl<B: Default> Default for QueryCache<B>

fn default() -> Self

Returns the “default value” for a type.