Struct CacheManager 

pub struct CacheManager { /* private fields */ }

缓存管理器

Implementations

impl CacheManager

pub async fn new(config: CacheConfig) -> Result<Self>

创建新的缓存管理器

impl CacheManager

pub fn generate_query_cache_key( &self, table: &str, conditions: &[QueryCondition], options: &QueryOptions, ) -> String

生成查询缓存键 - 优化版本，避免复杂序列化

pub fn generate_condition_groups_cache_key( &self, table: &str, condition_groups: &[QueryConditionGroup], options: &QueryOptions, ) -> String

生成条件组合查询缓存键

impl CacheManager

pub async fn invalidate_record(&self, table: &str, id: &IdType) -> Result<()>

删除单个记录的缓存

pub async fn invalidate_table(&self, table: &str) -> Result<()>

清理表的所有缓存

pub async fn clear_all(&self) -> Result<()>

清理所有缓存

pub async fn clear_by_pattern(&self, pattern: &str) -> Result<usize>

按模式清理缓存（支持通配符匹配）

参数

• pattern - 缓存键模式，支持通配符 * 和 ?

示例

// 清理所有用户表相关的缓存
cache_manager.clear_by_pattern("rat_quickdb:users:*").await?;
// 清理所有查询缓存
cache_manager.clear_by_pattern("*:query:*").await?;

pub async fn clear_records_batch( &self, table: &str, ids: &[IdType], ) -> Result<usize>

批量清理记录缓存

参数

• table - 表名
• ids - 要清理的记录ID列表

pub async fn force_cleanup_expired(&self) -> Result<usize>

强制清理过期缓存

手动触发过期缓存的清理，通常用于内存紧张或需要立即释放空间的场景

pub async fn warmup_cache( &self, table: &str, hot_ids: &[IdType], ) -> Result<usize>

缓存预热 - 预加载热点数据

参数

• table - 表名
• hot_ids - 热点数据ID列表

pub async fn cache_records_batch_optimized( &self, table: &str, records: &[(IdType, DataValue)], ) -> Result<usize>

批量缓存记录 - 优化批量操作

参数

• table - 表名
• records - 记录列表

pub async fn list_cache_keys(&self) -> Result<HashMap<String, Vec<String>>>

获取所有缓存键列表（按表分组）

用于调试和监控，可以查看当前缓存中有哪些键

pub async fn list_table_cache_keys(&self, table: &str) -> Result<Vec<String>>

获取指定表的缓存键列表

pub async fn clear_table_query_cache(&self, table: &str) -> Result<usize>

清理指定表的查询缓存

只清理查询缓存，保留记录缓存

pub async fn clear_table_record_cache(&self, table: &str) -> Result<usize>

清理指定表的记录缓存

只清理记录缓存，保留查询缓存

pub async fn get_stats(&self) -> Result<CacheStats>

获取缓存统计信息

pub async fn get_performance_stats(&self) -> Result<CachePerformanceStats>

获取详细的性能统计信息

pub async fn reset_stats(&self) -> Result<()>

重置统计信息

pub fn is_enabled(&self) -> bool

检查缓存是否启用

pub async fn cache_records_batch( &self, table: &str, records: Vec<(IdType, DataValue)>, ) -> Result<usize>

批量缓存记录 - 优化批量操作

参数

• table - 表名
• records - 记录列表

impl CacheManager

pub async fn cache_query_result( &self, table: &str, options: &QueryOptions, results: &[DataValue], ) -> Result<()>

pub async fn cache_condition_groups_result( &self, table: &str, condition_groups: &[QueryConditionGroup], options: &QueryOptions, results: &[DataValue], ) -> Result<()>

缓存条件组合查询结果

pub async fn get_cached_query_result( &self, table: &str, options: &QueryOptions, ) -> Result<Option<Vec<DataValue>>>

获取缓存的查询结果 - 优化版本

pub async fn get_cached_condition_groups_result( &self, table: &str, condition_groups: &[QueryConditionGroup], options: &QueryOptions, ) -> Result<Option<Vec<DataValue>>>

获取缓存的条件组合查询结果

impl CacheManager

pub async fn cache_record( &self, table: &str, id: &IdType, data: &DataValue, ) -> Result<()>

pub async fn get_cached_record( &self, table: &str, id: &IdType, ) -> Result<Option<DataValue>>

获取缓存的记录

Trait Implementations

impl Clone for CacheManager

fn clone(&self) -> CacheManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheManager

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

Formats the value using the given formatter.