SpringCloudAlibaba之SentinelResource注解

2020/2/2 8:27:31 0点赞 0收藏 0评论
前言

在前一篇文章中,我们介绍了如何使用Sentinel的Api进行限流降级,但我们发现实现起来比较麻烦,而且重复代码非常多;今天老顾就介绍一下@SentinelResource注解,如何利用此注解简化代码。

自定义资源

用注解方式定义资源,其实非常简单,在需要通过Sentinel来控制流量的地方使用@SentinelResource注解,比如下面以控制请求入口的某个方法为例:

到这里一个需要被保护的方法就定义完成了,非常简单吧;下面我们分别说说,定义了资源点之后,我们如何实现不同的保护策略,包括:限流、降级等。

在定义了资源点之后,我们就可以通过Dashboard来设置限流和降级策略来对资源点进行保护了。同时,也可以通过@SentinelResource来指定出现限流和降级时候的异常处理策略。下面,就来一起分别看看限流和降级都是如何实现的。
实现限流控制

启动应用,启动Sentinel-Dashboard。发一个请求到/test-sentinel-resource接口上,使得Sentinel-Dashboard上可以在簇点链路上看到定义的资源:

对资源设置流控规则

快速请求http://localhost/test-sentinel-resource?a=1,超过流控阀值,发现服务器报了流量异常

表明了流控起到了效果。

实现限流的异常处理

默认情况下,Sentinel对控制资源的限流处理是直接抛出异常,也就是上面贴出的日志内容。在没有合理的业务承接或者前端对接情况下可以这样,但是正常情况为了更好的用户业务,都会实现一些被限流之后的特殊处理,我们不希望展示一个生硬的报错。那么只需要基于上面的例子做一些加工,比如:

上面的代码,主要做了两件事:

  • 通过@SentinelResource注解的blockHandler属性制定具体的处理函数
  • 实现处理函数,该函数的传参必须与资源点的传参一样,并且最后加上BlockException异常参数;同时,返回类型也必须一样。
完成上面的改动之后,再尝试访问接口(注意限流规则需要配置好),此时前端就不会返回异常信息了,后端会打印blockHandler中定义的日志输出。而在实际应用的时候,只要根据业务需要对限流请求做缓存或者前端提示等都可以基于此方法来实现。

实现熔断降级

@SentinelResource注解除了可以用来做限流控制之外,还能实现与Hystrix类似的熔断降级策略。下面就来具体看看如何使用吧。

上面的案例代码,如果不传参数a,就会报异常;正好可以测试降级

我们来配置一下降级策略

快速刷新请求http://localhost/test-sentinel-resource,服务器报了降级异常

不过我们在前端,发现返回是限流了

这个代表了降级策略,也会进入定义的blockHandler方法。但如果我们要区分出降级的异常,降级的处理方式需要另外处理,可以利用fallback属性

熔断的降级处理

在Sentinel中定义熔断的降级处理方法非常简单,与Hystrix非常相似。只需要使用@SentinelResource注解的fallback属性来指定具体的方法名即可。这里也需要注意传参与返回必须一致。比如:

请求接口不传参数a,就会返回降级

更多注解属性说明
  • value:资源名称,必需项(不能为空)
  • entryType:entry类型,可选项(默认为 EntryType.OUT)
  • blockHandler / blockHandlerClass: blockHandler对应处理 BlockException 的函数名称,可选项。blockHandler 函数访问范围需要是 public,返回类型需要与原方法相匹配,参数类型需要和原方法相匹配并且最后加一个额外的参数,类型为 BlockException。blockHandler 函数默认需要和原方法在同一个类中。若希望使用其他类的函数,则可以指定 blockHandlerClass为对应的类的 Class对象,注意对应的函数必需为 static 函数,否则无法解析。
  • fallback:fallback 函数名称,可选项,用于在抛出异常的时候提供 fallback 处理逻辑。fallback 函数可以针对所有类型的异常(除了exceptionsToIgnore里面排除掉的异常类型)进行处理。fallback 函数签名和位置要求:
  • 返回值类型必须与原函数返回值类型一致;
  • 方法参数列表需要和原函数一致,或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。
  • fallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数,则可以指定fallbackClass为对应的类的 Class 对象,注意对应的函数必需为 static 函数,否则无法解析。
  • defaultFallback(since 1.6.0):默认的 fallback 函数名称,可选项,通常用于通用的 fallback 逻辑(即可以用于很多服务或方法)。默认 fallback 函数可以针对所有类型的异常(除了exceptionsToIgnore里面排除掉的异常类型)进行处理。若同时配置了 fallback 和 defaultFallback,则只有 fallback 会生效。defaultFallback 函数签名要求
  • 返回值类型必须与原函数返回值类型一致;
  • 方法参数列表需要为空,或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。
  • defaultFallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数,则可以指定 fallbackClass 为对应的类的 Class 对象,注意对应的函数必需为 static 函数,否则无法解析。
  • exceptionsToIgnore(since 1.6.0):用于指定哪些异常被排除掉,不会计入异常统计中,也不会进入 fallback 逻辑中,而是会原样抛出。
总结

blockHandler 和 fallback 都进行了配置,则被限流降级而抛出 BlockException 时只会进入 blockHandler 处理逻辑。若未配置 blockHandler、fallback 和 defaultFallback,则被限流降级时会将 BlockException 直接抛出。

从 1.4.0 版本开始,注解方式定义资源支持自动统计业务异常, 无需手动调用 Tracer.trace(ex) 来记录业务异常。Sentinel 1.4.0 以前的版本需要自行调用 Tracer.trace(ex) 来记录业务异常。

如果喜欢本文,可以关注我们的官方账号,第一时间获取资讯。

你的关注是对我们更新最大的动力哦~

文章不错,打赏作者

打赏
0人已打赏
本文作者 喜欢就打赏TA哟

仓鼠姐妹 LV2

687爆料 16粉丝

0评论