Table of Contents

二级缓存

KernLab.Loom.Ef.Runtime.Caching——查询级二级缓存(#149/#150):Loom 只定义 SPI,不绑定具体存储; 缺省进程内内存适配,分布式(Redis 等)整体替换 ILoomSecondLevelCache 即可。

从零跑通

// 缺省内存适配自动注册(LoomEfOptions.SecondLevelCache.Enabled = true 缺省开)
// 逐查询 opt-in——零调用零影响

var list = await db.Orders
    .Where(o => o.CustomerId == cid)
    .LoomCachedToListAsync(db, cacheKey: $"customer:{cid}", timeToLive: TimeSpan.FromMinutes(2));

语义:LoomCachedToListAsync 强制 AsNoTracking()——缓存值是跨上下文快照,返回新 List<T>; 调用方只读消费(修改元素会污染缓存,修改列表本身不影响)。

选项(LoomEfOptions.SecondLevelCache)

项 缺省 说明
Enabled true 注册缺省内存适配(查询助手仍逐查询 opt-in)
MaxEntries 10,000 超出按 LRU 淘汰(O(1) 链式;构造期快照)
DefaultTimeToLive 5 分钟 助手未显式传 TTL 时的缺省

构造期快照(BuildServiceProvider 后修改不生效)。RemoveByPrefix 为 O(n) 扫描(任意前缀契约;每次保存按变更实体前缀调用,成本随缓存容量线性有界)。配置键 loom.SecondLevelCache.*。

缓存查询

var a = await q.LoomCachedToListAsync(ctx, "key-a");                 // 缺省 TTL
var b = await q.LoomCachedToListAsync(ctx, "key-b", TimeSpan.FromMinutes(1));
  • 业务键须覆盖全部结果决定因素(谓词/参数/culture/租户)——键不含实体前缀(前缀自动加)。
  • 缓存未注册 = 显式异常("二级缓存未注册——启用 loom.SecondLevelCache 或注册 ILoomSecondLevelCache")——静默不缓存 = 假能力,违反缺省安全。

失效协议

时机 行为
SaveChanges 成功 按变更实体类型前缀失效(RemoveByPrefix——失效协议唯一必需操作)
受管批写 / 恢复 按实体失效
原始 SQL 全清
原生 ExecuteUpdate/ExecuteDelete 绕过 SaveChanges——调用方须显式 LoomInvalidateCache<TEntity>()(设计边界)

键空间约定:loom:q:{实体全名}:{业务键}——失效按实体前缀删除。

SPI 与分布式

public interface ILoomSecondLevelCache
{
    bool TryGet<T>(string key, out T? value);
    void Set<T>(string key, T value, TimeSpan? timeToLive = null);   // null = 删除
    bool Remove(string key);
    int RemoveByPrefix(string prefix);                                // 实体级失效
}

Redis 等实现整体替换本接口即可,失效协议由实现方承载(一致性边界见查询)。

诚实边界

  • 缓存一致性 = 最终一致(TTL + 保存路径失效);跨进程共享缓存由分布式实现方保证。
  • 原生 EF 批量更新路径不在失效自动覆盖内——显式失效是调用方职责。