Struct PreparedStatementCache 

pub struct PreparedStatementCache { /* private fields */ }

PreparedStatement 句柄缓存

按连接 ID 分桶存储句柄，bucket 级别 LRU 淘汰。 句柄以闭包形式存储，避免在 sz-orm-core 暴露 SQLx 类型。

Implementations

impl PreparedStatementCache

pub fn new(max_size_per_conn: usize) -> Self

创建新缓存，指定每连接最大缓存数

max_size_per_conn 默认 256（与 design.md 2.1.2 配置项一致）

pub async fn get_or_prepare( &self, conn_id: ConnId, sql: &str, params: &[Value], ) -> Result<PreparedLookup, DbError>

查找或执行缓存句柄

• 命中：调用 execute_fn(params) 返回 PreparedLookup::Hit(rows)
• 未命中：返回 PreparedLookup::Miss，调用方需 prepare 后调用 store_handle
• 执行错误：返回 Err(DbError)，调用方应降级直接执行

pub fn store_handle( &self, conn_id: ConnId, sql: &str, tables: Vec<String>, execute_fn: ExecuteFn, )

存储句柄（prepare 后调用）

若 bucket 已满，LRU 淘汰最久未使用的条目。

pub fn invalidate_table(&self, table: &str) -> usize

表级失效：清除该表关联的所有句柄

返回失效条目数

pub fn invalidate_conn(&self, conn_id: ConnId) -> usize

连接级失效：清除该连接整个 bucket

连接关闭时调用，返回失效条目数

pub fn stats(&self) -> PreparedStatementCacheStatsSnapshot

统计快照

pub fn len(&self) -> usize

当前条目数（调试/测试用）

pub fn is_empty(&self) -> bool

是否为空

Trait Implementations

impl Default for PreparedStatementCache

fn default() -> Self

Returns the “default value” for a type.