用于定义资源,并提供可选的异常处理和 fallback 配置项。 @SentinelResource 注解包含以下属性:

  • value: 资源名称,必需项(不能为空)
  • entryType: 入口类型,可选项(默认为 EntryType.OUT)
  • blockHandler / blockHandlerClass: blockHandler 对应处理 BlockException 的函数名称,可选项。若未配置,则将 BlockException 直接抛出。blockHandler 函数访问范围需要是 public,返回类型需要与原方法相匹配,参数类型需要和原方法相匹配并且最后加一个额外的参数,类型为 BlockException。blockHandler 函数默认需要和原方法在同一个类中。若希望使用其他类的函数,则可以指定 blockHandlerClass 为对应的类的 Class 对象,注意对应的函数必需为 static 函数,否则无法解析。
  • fallback: fallback 函数名称,可选项,仅针对降级功能生效(DegradeException)。fallback 函数的访问范围需要是 public,参数类型和返回类型都需要与原方法相匹配,并且需要和原方法在同一个类中。
    若 blockHandler 和 fallback 都进行了配置,则遇到降级的时候首先选择 fallback 函数进行处理。

示例:

  1. public class TestService {
  2.  
  3. // 对应的 `handleException` 函数需要位于 `ExceptionUtil` 类中,并且必须为 static 函数.
  4. @SentinelResource(value = "test", blockHandler = "handleException", blockHandlerClass = {ExceptionUtil.class})
  5. public void test() {
  6. }
  7.  
  8. // 原函数
  9. @SentinelResource(value = "hello", blockHandler = "exceptionHandler", fallback = "helloFallback")
  10. public String hello(long s) {
  11. return String.format("Hello at %d", s);
  12. }
  13.  
  14. // Fallback 函数,函数签名与原函数一致.
  15. public String helloFallback(long s) {
  16. return String.format("Halooooo %d", s);
  17. }
  18. // Block 异常处理函数,参数最后多一个 BlockException,其余与原函数一致.
  19. public String exceptionHandler(long s, BlockException ex) {
  20. // Do some log here.
  21. ex.printStackTrace();
  22. return "Oops, error occurred at " + s;
  23. }
  24. }

配置

Spring AOP

若您的应用使用了 Spring AOP,您需要通过配置的方式将 SentinelResourceAspect 注册为一个 Spring Bean:


  1. public class SentinelAspectConfiguration {
  2. }