sentinel中监听器的运用--规则管理-编程知识

sentinel中监听器的运用–规则管理

规则结构

类图关系

类关系图如下
在这里插入图片描述

Rule

将规则抽象成一个类, 规则与资源是紧密关联的, 也就是说规则作用于资源。因此, 我们需要将规则表示为一个类, 并包含一个获取资源的方法

这里采用接口的原因就是规则是一个抽象概念而非具体实现。所以我们将规则定义为接口, 让各个子类（如黑白名单规则、流量控制规则、熔断降级等规则）实现各自的逻辑

public interface Rule {// 获取资源 nameString getResource();
}

AbstractRule

规则通用的三个字段, 设置抽象类实现Rule接口, 对下述字段复用

规则id
资源名称
限制来源
- 限制来源指的是诸如黑名单值、白名单值等, 也就是说限制哪些来源访问

// 实现规则 Rule 接口
public abstract class AbstractRule implements Rule {// 规则idprivate Long id;// 资源名称private String resource;// 限制来源, 多个用逗号隔开, 比如黑名单规则, 限制userId是1和3的访问, 那么就写setLimitApp(1,3)private String limitApp;@Overridepublic String getResource() {return resource;}
}

为什么limitApp不使用 List<String>？

其实两者都是可行的, 你可以使用逗号分隔, 也可以使用 List<String>, 只要能满足需求即可

规则管理

PropertyListener接口

如何管理这些规则呢？比如如何感知到规则的变化？

sentinel采用的是监听器监听规则的变化, 这个监听器是PropertyListener

/*** 当SentinelProperty.updateValue(Object) 需要通知监听器时, 此类保存回调方法* 这里的泛型T存储的是规则, 如 AuthorityRule、DegradeRule、FlowRule 等*/
public interface PropertyListener<T> {/*** 规则变更时触发的方法* @param value 更新的value*/void configUpdate(T value);/*** 首次加载规则时触发* @param value value加载的值*/void configLoad(T value);
}

为什么使用泛型 T 而不是接口 Rule？我们 AuthorityRule、DegradeRule 等类不都是接口 Rule 的子类吗？

这里使用泛型 T 是因为此接口不仅服务于规则 Rule, 还服务于Sentinel的其他场景, 所以采用了泛型 T

因此, 会有很多具体的类去实现 PropertyListener<T>, 并传入具体的类型, 例如, FlowPropertyListener

// com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManagerpublic class FlowRuleManager {// 其他代码...// 这个是内布类, 实现 PropertyListener 接口, 并传入具体的类型 List<FlowRule>private static final class FlowPropertyListener implements PropertyListener<List<FlowRule>> {// 方法参数也是具体类型, 而不是泛型 T@Overridepublic synchronized void configLoad(List<FlowRule> value) {// 做一些变更逻辑}// 方法参数也是具体类型, 而不是泛型 T@Overridepublic synchronized void configUpdate(List<FlowRule> conf) {// 做首次初始化逻辑}}// 其他代码...
}

为什么类型是 List<FlowRule> 而不是FlowRule呢?

因为一个资源可以对应多个规则, 而不是简单的一个规则, 比如上线的流控规则, QPS是一种, 线程数又是一种, 一个资源多种策略, 一对多的关系, 所以采用List集合

PropertyListener<T>的实现类如下图
在这里插入图片描述

SentinelProperty接口

SentinelProperty 的类, 专门负责管理所有 PropertyListener<T> 子类的监听器

包含以下方法：

addListener(PropertyListener<T> listener)：添加监听器。
removeListener(PropertyListener<T> listener)：移除监听器。
updateValue(T newValue)：当规则配置发生变化时, 调用此方法进行通知

public interface SentinelProperty<T> {// 添加监听器void addListener(PropertyListener<T> listener);// 移除监听器void removeListener(PropertyListener<T> listener);// 当配置发生变化时, 通过调用 SentinelProperty 的 updateValue 方法通知所有的监听器boolean updateValue(T newValue);
}

DynamicSentinelProperty

Sentinel 提供了一个默认的 SentinelProperty 实现：DynamicSentinelProperty

// 实现 SentinelProperty 接口
public class DynamicSentinelProperty<T> implements SentinelProperty<T> {// 使用 `CopyOnWriteArraySet` 存储所有监听器 `PropertyListener` 子类, 确保线程安全和高性能protected Set<PropertyListener<T>> listeners = new CopyOnWriteArraySet<>();private T value = null;public DynamicSentinelProperty() {}public DynamicSentinelProperty(T value) {super();this.value = value;}// 添加监听器到集合@Overridepublic void addListener(PropertyListener<T> listener) {listeners.add(listener);// 添加进来后就会初始化规则配置listener.configLoad(value);}// 移除监听器@Overridepublic void removeListener(PropertyListener<T> listener) {listeners.remove(listener);}// 更新值@Overridepublic boolean updateValue(T newValue) {// 如果值没变化, 直接返回if (isEqual(value, newValue)) {return false;}// 如果值发生了变化, 则告知每一个“观察者"value = newValue;for (PropertyListener<T> listener : listeners) {listener.configUpdate(newValue);}return true;}
}

监听器监听的是规则，而规则又是和资源绑定的，因此具体使用时，我们可以创建一个 Map<String resourceName, Set<Rule>> 这样的数据结构来保存资源和规则的关系

当规则首次初始化时调用 SentinelProperty#addListener() 方法注册监听器且进行初始化（初始化的过程就是将资源和规则绑定到 Map 当中）
当规则发生变更时，调用 SentinelProperty#updateValue() 方法将 Map 里的value进行变更