java元注解 @Retention注解使用

@Retention定义了该 Annotation 被保留的时间长短:

1. 某些 Annotation 仅出现在源代码中,而被编译器丢弃;

2. 另一些却被编译在 class 文件中,注解保留在 class 文件中,在加载到 JVM 虚拟机时丢弃,这是默认行为,所以没有用 Retention 注解的注解,都会采用这种策略

3. 而另一些在 class 被装载时将被读取,注解保留在程序运行期间,此时可以通过反射获得定义在某个类上的所有注解

  作用:表示需要在什么级别保存该注释信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效)

  取值(RetentionPoicy)有:

    1.SOURCE: 在源文件中有效(即源文件保留)
    2.CLASS: 在 class 文件中有效(即 class 保留)
    3.RUNTIME: 在运行时有效(即运行时保留)

  Retention meta-annotation 类型有唯一的 value 作为成员

它的取值来自 java.lang.annotation.RetentionPolicy 的枚举类型值。具体实例如下:

/**
* 限流注解
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RateLimit {
/**
* @return rate limit in queries per second
*/
String value() default "";
double permits() default 1000;
}

 RateLimit 注解的的 RetentionPolicy 的属性值是 RUNTIME, 这样注解处理器可以通过反射,获取到该注解的属性值,从而去做一些运行时的逻辑处理