更新时间:2025-01-09 GMT+08:00
服务优先
clientcontrol提供了一种名为服务优先的功能。当使用服务优先功能时,在执行目标业务代码时,优先执行业务代码并返回,如果业务代码报错则去查询缓存并返回。具体使用方式如下:
- pom文件添加依赖。
- 配置文件,参考下面配置样例。
devspore: client-control: caches: test: ttl: 60000 #此处配置的是缓存的有效时长 performance-ttl: 30000 #此处配置的是一个性能缓存,时长一般低于ttl, 当缓存的时间小于性能缓存时,clientcontrol会直接把性能缓存作为方法返回值返回 type: redis 此处配置的是 缓存类型, 支持 redis/caffine 指定具体缓存类型后,用户需要手动引入相关的依赖 maximum-size: 60000 redis-connection-factory-bean-name: redisConnectionFactory # 当使用redis的时候,需要将redis的连接工厂的bean的名称配置在这里 rules: fallbackTest: # 此处配置的是一个别名,用户可自定义,具体使用地方是在注解上 time-limit: enable: false retry: enable: false fallback: # 默认开启 enable: true # 慢调用时间(超过即为慢调用,单位s,默认60S) slow-call-duration-threshold: 30 # 慢调用熔断比例(慢调用数量达到比例则熔断,默认100等于关闭状态) slow-call-rate-threshold: 100 #失败百分比(触发断路器,默认50%) failure-rate-threshold: 50 #滑动窗口类型(COUNT_BASED/TIME_BASED,数量/时间,默认时间) sliding-window-type: COUNT_BASED #滑动窗口大小(默认100,数量:次/时间:秒) sliding-window-size: 5 #滑动窗口内最小请求数(默认100) 必须满足这个要求,才会触发断路器 不满足,不管失败率多少都不会触发 minimum-number-of-calls: 5 #进入半开所需时间(默认60s,单位ms) wait-duration-in-open-state: 10000 #半开状态允许通过的请求数量,默认10个请求(失败比例达到设置的百分比,断路器继续打开,再次等待进入半开)注:不大于滑动窗口内最小请求数,相对较小的配置优先起作用,所以如果大于滑动窗口最小请求,起作用的就是滑动窗口最小请求数了 permitted-number-of-calls-in-half-open-state: 5
- 目标方法上添加@ClientControl注解,且policy属性设置为CacheOrder.SERVICECALLFIRST,rule属性选择配置文件中自己定义的rules名称(本示例中使用fallbackTest),cacheManagerName属性选择配置文件中自己定义的caches的名称(本示例使用test)。
@ClientControl(rule = "fallbackTest", policy = CacheOrder.SERVICECALLFIRST, cacheManagerName = "test") public String testClientControlJiangji(Integer id) { int i = 1 / id; return new User(id, "vn", 12).toString(); }
当使用服务优先时clientcontrol的处理逻辑如下:
- 执行原方法,如果执行成功,更新缓存,返回结果。如果执行方法失败,获取缓存。
- 如果成功拿到缓存,则将缓存结果返回。如果没有拿到缓存则将原方法的执行失败异常返回。
父主题: 使用熔断降级功能