Sentinel学习笔记（三）

sentinel客户端定义资源

首先我们需要先了解一个注解 @SentinelResource
@SentinelResource可以说是Sentinel学习的突破口，搞懂了这个注解的应用，
基本上就搞清楚了 Sentinel 的大部分应用场景。
一、@SentinelResource 解析
Sentinel 提供了 @SentinelResource 注解用于定义资源，
并提供了 AspectJ 的扩展用于自动定义资源、处理 BlockException 等。
1、SentinelResource源码
查看 Sentinel的源码，可以看到 SentinelResource 定义了value,
entryType,resourceType,blockHandler,fallback,defaultFallback等属性。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface SentinelResource {

    /**
     * @return 
     */
    String value() default "";

    /**
     * @return the entry type (inbound or outbound), outbound by default
     */
    EntryType entryType() default EntryType.OUT;

    /**
     * @return the classification (type) of the resource
     * @since 1.7.0
     */
    int resourceType() default 0;

    /**
     * @return name of the block exception function, empty by default
     */
    String blockHandler() default "";

    /**
     * The {@code blockHandler} is located in the same class with the original method by default.
     * However, if some methods share the same signature and intend to set the same block handler,
     * then users can set the class where the block handler exists. Note that the block handler method
     * must be static.
     * @return the class where the block handler exists, should not provide more than one classes
     */
    Class<?>[] blockHandlerClass() default {};

    /**
     * @return name of the fallback function, empty by default
     */
    String fallback() default "";

    /**
     * The {@code defaultFallback} is used as the default universal fallback method.
     * It should not accept any parameters, and the return type should be compatible
     * @return name of the default fallback method, empty by default
     * @since 1.6.0
     */
    String defaultFallback() default "";

    /**
     * The {@code fallback} is located in the same class with the original method by default.
     * However, if some methods share the same signature and intend to set the same fallback,
     * then users can set the class where the fallback function exists. Note that the shared fallback method
     * @return the class where the fallback method is located (only single class)
     * @since 1.6.0
     */
    Class<?>[] fallbackClass() default {};

    /**
     * @return the list of exception classes to trace, {@link Throwable} by default
     * @since 1.5.1
     */
    Class<? extends Throwable>[] exceptionsToTrace() default {Throwable.class};
    
    /**
     * Indicates the exceptions to be ignored. Note that {@code exceptionsToTrace} should
     * not appear with {@code exceptionsToIgnore} at the same time, or {@code exceptionsToIgnore}
     * will be of higher precedence.
     *
     * @return the list of exception classes to ignore, empty by default
     * @since 1.6.0
     */
    Class<? extends Throwable>[] exceptionsToIgnore() default {};
}

2、属性说明
参考源码的注释，逐个解释下这几个属性的作用。
value
资源名称，必需项，因为需要通过resource name找到对应的规则，这个是必须配置的。
entryType
entry 类型，可选项，
有IN和OUT两个选项，默认为 EntryType.OUT（IN 表示入口流量一般用在provider层，OUT表示出口流量一般用在控制层）
blockHandler
blockHandler 对应处理 BlockException 的函数名称，可选项。

blockHandler 函数访问范围需要是 public，返回类型需要与原方法相匹配，参数类型需要和原方法相匹配并且最后加一个额外的参数，类型为 BlockException。

blockHandlerClass
blockHandler 函数默认需要和原方法在同一个类中，如果希望使用其他类的函数，则需要指定 blockHandlerClass 为对应的类的 Class 对象，注意对应的函数必需为 static 函数，否则无法解析。

fallback
fallback 函数名称，可选项，用于在抛出异常的时候提fallback 处理逻辑。fallback 函数可以针对所有类型的异常（除了 exceptionsToIgnore 里面排除掉的异常类型）进行处理。

fallbackClass
fallbackClass的应用和blockHandlerClass类似，fallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数，则可以指定 fallbackClass 为对应的类的 Class 对象，注意对应的函数必需为 static 函数，否则无法解析。

defaultFallback（since 1.6.0）
如果没有配置defaultFallback方法，默认都会走到这里来。默认的 fallback 函数名称，可选项，通常用于通用的 fallback 逻辑。默认 fallback 函数可以针对所有类型的异常（除了exceptionsToIgnore 里面排除掉的异常类型）进行处理。
若同时配置了 fallback 和 defaultFallback，则只有 fallback 会生效。

exceptionsToIgnore（since 1.6.0）
用于指定哪些异常被排除掉，不会计入异常统计中，也不会进入 fallback 逻辑中，而是会原样抛出。

3、 资源定义代码示例

@SentinelResource(value = "hello", entryType = EntryType.OUT, blockHandlerClass = SentinelExceptionHandler.class,
        blockHandler = "helloExceptionHandle")
@GetMapping("/hello/{name}")
public String hello(@PathVariable("name") String name) {
    System.out.println(name);
    return "hello " + name;
}

SentinelExceptionHandler

public class SentinelExceptionHandler {

    final static Logger logger = LoggerFactory.getLogger(SentinelExceptionHandler.class);

    public static String helloExceptionHandle(String name, BlockException exception) {
        exception.printStackTrace();
        logger.info("sentinel 限流处理 {}", "SentinelExceptionHandler");
        return "Sentinel 限流处理函数";
    }

}