Struct IoReuseChannel 

pub struct IoReuseChannel { /* private fields */ }

连接池 IO 复用通道

在连接上复用 prepared statement 通道，减少重复 prepare 开销。 首次执行 SQL 时 prepare 并缓存句柄，后续执行直接复用缓存句柄。

需启用 pool-io-reuse feature。

Implementations

impl IoReuseChannel

pub fn new(max_size_per_conn: usize) -> Self

创建 IO 复用通道，内部持有 PreparedStatementCache

max_size_per_conn 为每连接最大缓存句柄数（默认 256）

pub async fn execute_reuse( &self, conn_id: ConnId, sql: &str, params: &[Value], tables: Vec<String>, prepare_fn: impl FnOnce() -> ExecuteFn, ) -> Result<QueryRows, DbError>

复用 prepared statement 通道执行查询

流程：

1. 查找缓存句柄 → 命中则直接执行返回
2. 未命中 → 调用 prepare_fn 获取执行闭包 → 缓存 → 执行返回

参数

• conn_id: 连接唯一标识
• sql: SQL 文本
• params: 参数列表
• tables: 涉及的表名列表（用于表级失效索引）
• prepare_fn: 首次执行时的 prepare 闭包，返回执行函数

pub fn stats(&self) -> PreparedStatementCacheStatsSnapshot

返回缓存统计快照

pub fn invalidate_conn(&self, conn_id: ConnId)

失效连接级缓存（连接关闭时调用）

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

失效表级缓存（表结构变更时调用）