Struct StatementCache 

pub struct StatementCache { /* private fields */ }

LRU-style cache for compiled SQL statements.

Keyed by a u64 hash that callers compute from their query structure. When the cache exceeds max_size, the least-recently-used entry is evicted.

Example

use sqlmodel_query::cache::StatementCache;

let mut cache = StatementCache::new(100);

// Cache a compiled query
let sql = cache.get_or_insert(12345, || "SELECT * FROM users WHERE id = $1".to_string());
assert_eq!(sql, "SELECT * FROM users WHERE id = $1");

// Second call returns cached version
let called = std::cell::Cell::new(false);
let sql2 = cache.get_or_insert(12345, || {
    called.set(true);
    "SELECT * FROM users WHERE id = $1".to_string()
});
assert_eq!(sql2, "SELECT * FROM users WHERE id = $1");
assert!(!called.get());

Implementations

impl StatementCache

pub fn new(max_size: usize) -> Self

Create a new cache with the given maximum number of entries.

pub fn get_or_insert( &mut self, key: u64, builder: impl FnOnce() -> String, ) -> &str

Get a cached statement or compile and insert it.

The builder closure is only called on cache miss.

pub fn contains(&self, key: u64) -> bool

Check if a statement is cached.

pub fn len(&self) -> usize

Get cache statistics.

pub fn is_empty(&self) -> bool

Check if cache is empty.

pub fn clear(&mut self)

Clear all cached statements.

Trait Implementations

impl Debug for StatementCache

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

Formats the value using the given formatter.

impl Default for StatementCache

fn default() -> Self

Returns the “default value” for a type.