二级缓存
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 批量更新路径不在失效自动覆盖内——显式失效是调用方职责。