写入缓存 @param key 缓存键 @param value 缓存值

获取缓存值 @param key 缓存键 @return 缓存值，不存在返回 null

记录一次访问，并判断是否应该继续传递给下游 @param context 上下文信息 @return true 表示频率达到阈值，应该传递给 L3 Sentinel； false 表示是冷数据，直接放行到安全回源

获取目标方法 @param joinPoint 切点 @param targetClass 目标类 @param methodName 方法名 @return 方法对象

安全加载数据（带防击穿保护） 执行流程：查 Redis -> 查 DB（带分布式锁） -> 回写 Redis @param context 上下文信息 @param dbLoader 数据库加载函数 @return 加载的数据

获取当前计数 @param context 上下文信息 @return 当前时间窗口内的访问次数

从 L1 缓存中获取数据 @param context 上下文信息 @return 缓存值，未命中返回 null

获取或创建指定资源的缓存实例 @param resource 资源名称 @param config L1 配置 @return Caffeine Cache 实例

获取或创建计数器缓存 @param resource 资源名称 @param config L2 配置 @return 计数器缓存

解析表达式，获取缓存键 @param expression SpEL 表达式 @param joinPoint 切点 @param targetClass 目标类 @param methodName 方法名 @return 解析后的值

注册配置 @param resource 资源名称 @param config L4 配置

处理 @HotArmorCache 注解的方法调用 @param joinPoint 切点 @param context 上下文信息 @return 方法返回值 @throws Throwable 异常

检查是否触发热点限流 @param context 上下文信息 @return true 表示触发热点（需要晋升到 L1），false 表示正常通过

处理 @HotArmorEvict 注解的方法调用 @param joinPoint 切点 @param context 上下文信息 @param beforeInvocation 是否在方法执行前删除 @param delayedDelete 是否延迟删除 @param broadca

处理数据更新（完整的一致性流程） 包括：立即删除 Redis -> 发送延迟消息 -> 发送广播通知 @param context 上下文信息

将数据写入 L1 缓存 @param context 上下文信息 @param value 要缓存的值

查看所有规则配置

删除缓存 @param key 缓存键

从数据库加载数据 @param context 上下文 @param dbLoader 数据库加载函数 @return 数据

解析条件表达式 @param expression SpEL 表达式 @param joinPoint 切点 @param targetClass 目标类 @param methodName 方法名 @return true 表示条件满足，false 表示不满足

清空所有缓存

注册一致性配置 @param resource 资源名称 @param config 一致性配置

删除 Redis 中的数据 @param context 上下文信息

从 Redis 获取数据 @param context 上下文信息 @return Redis 中的数据，不存在返回 null

配置源类型标识 @return 类型名称（如 "nacos", "apollo", "local"）

只删除 Redis（用于手动触发） @param context 上下文信息

从数据源加载数据 @param joinPoint 切点 @param context 上下文 @param promoteToL1 是否晋升到 L1 @return 数据 @throws Throwable 异常

应用规则（首次加载） @param rule 规则

根据配置构建 Caffeine Cache @param config L1 配置 @return Caffeine Cache 实例

构建计数器缓存 @param config L2 配置 @return 计数器缓存

创建 SpEL 求值上下文 安全说明：使用 SimpleEvaluationContext 替代 StandardEvaluationContext SimpleEvaluationContext 只允许访问属性和调用简单方法，不能执行任意代码， 有效防止 SpEL 表达式注入攻击 @param

获取所有规则 @return 所有规则列表

获取缓存统计信息 @return 统计信息对象

处理配置变更 @param config 配置内容

处理缓存失效 @param context 上下文 @param delayedDelete 是否延迟双删 @param broadcast 是否广播

处理缓存失效消息

清空当前资源的所有缓存 @param resource 资源名称

将所有规则加载到 Sentinel

通知规则添加

解析配置 @param config JSON 配置字符串 @return 规则列表

重建指定资源的缓存实例（用于配置热更新） @param resource 资源名称 @param config 新的 L1 配置

重建计数器（用于配置热更新） @param resource 资源名称 @param config 新的 L2 配置

注册或重新注册内部监听器 每次设置新的 listener 时都要重新注册，确保监听器持有最新的引用

重置计数器（用于规则更新） @param resource 资源名称

更新 Sentinel 规则 @param resource 资源名称 @param qpsThreshold QPS 阈值 @param durationInSec 统计时长

验证规则配置 @param rule 规则 @throws IllegalArgumentException 如果规则无效

添加规则变更监听器 @param listener 监听器

计算 RocketMQ 延迟级别 延迟级别对应关系： 1=1s, 2=5s, 3=10s, 4=30s, 5=1m, 6=2m, 7=3m, 8=4m, 9=5m, 10=6m, 11=7m, 12=8m, 13=9m, 14=10m, 15=20m, 16=30m, 17=1h, 18=2h @

立即删除（第一次删除） @param context 上下文信息

根据异常类型判断失败原因 @param e 异常 @return 失败原因

获取所有缓存实例（用于监控） @return 缓存实例映射

获取分布式锁的键 @param context 上下文 @return 锁键

根据ID查询商品

获取 Redis 键名 @param context 上下文信息 @return Redis 键

根据资源名称获取规则 @param resource 资源名称 @return 规则配置，不存在返回 null

根据ID查询用户

处理延迟删除消息 @param context 上下文信息

处理加载异常 @param e 加载异常

处理热点晋升消息

处理热点晋升（发送晋升广播） 当本地节点检测到热点并晋升到L1后，通知其他节点也晋升 @param context 上下文信息 @param value 缓存值（可选）

计算命中率 @return 命中率（0.0 ~ 1.0）

初始化方法（可选）

使指定键的缓存失效 @param context 上下文信息

创建失效消息

加载规则（首次加载或全量更新） @param rules 规则列表

判断是否需要重建 L1 缓存 @param oldConfig 旧配置 @param newConfig 新配置 @return true 需要重建

判断是否需要重建 L2 计数器 @param oldConfig 旧配置 @param newConfig 新配置 @return true 需要重建

判断是否需要更新 L3 规则 @param oldConfig 旧配置 @param newConfig 新配置 @return true 需要更新

通知规则删除

通知规则更新

处理缓存失效事件 @param context 上下文信息

处理热点晋升通知 @param context 上下文信息 @param value 缓存值（可选，可能为null）

规则添加时触发 @param rule 新增的规则

规则删除时触发 @param rule 被删除的规则

规则更新时触发 注意：这里可能是参数微调（热更新）或结构变化（需要重建实例） @param oldRule 旧规则 @param newRule 新规则

创建晋升消息

发布缓存失效消息 @param context 上下文信息

发布热点晋升消息 通知其他节点将指定key晋升到L1缓存 @param context 上下文信息 @param value 缓存值（可选，如果为null则其他节点需要自行加载）

将数据写入 Redis @param context 上下文信息 @param value 要缓存的值

删除规则 @param resource 资源名称

发送延迟删除消息 @param context 上下文信息 @param delayTimeMs 延迟时间（毫秒）

关闭一致性管理器

优雅关闭延迟删除调度器

启动消费者