[Java 8] Java 8 中的可重复注释

在有的情况下，你可能想要在同一个元素上面使用相同的 Annotation 注释多次。这在 Java 8 版本之前是做不到的。从 Java 8 开始提供了可重复注释（repeating annotations）能够让你达到这个目的。

什么时候需要用到可重复注释呢？假设你需要让一个方法在每个月的最后一天和每周五的 23:00 执行一次，那么你可以像下面这样添加注释：

@Schedule(dayOfMonth="last")
@Schedule(dayOfWeek="Fri", hour="23")
public void doPeriodicCleanup() { ... }

上面这个例子在方法上添加了可重复注释，当然，你也可以像其它 Annotation 一样，将重复注释添加到任何你想添加的地方。例如，如果你想要让你的类处理未授权的访问异常，你可以像下面这样添加注释：

@Alert(role="Manager")
@Alert(role="Administrator")
public class UnauthorizedAccessException extends SecurityException { ... }

为了兼容性考虑，可重复注释是保存在容器 Annotation（container annotation）中的，在编译的时候由 Java 编译器自动生成容器 Annotation，并将可重复注释存放到容器 Annotation 中。因此为了让编译器能够做到这一点，你的代码中必须要包含两个 Annotation 声明。下面看看步骤：

第一步、声明可重复 Annotation 类型

Annotation 类型必须要添加 @Repeatable 元注释，例如：

@Repeatable(Schedules.class)
public @interface Schedule { ... }

@Repeatable 后面的小括号中是用来存放可重复注释的容器 Annotation 名称，容器 Annotation 由 Java 编译器生成，并用来存放可重复注释。在这个例子中，容器 Annotation 名称是 Schedules，因此可以这么说，@Schedule 是存放在 @Schedules 中的。
记住，如果要在 Java 的同一个元素上重复使用注释，那么在声明注释的时候 @Repeatable 元注释不可或缺，否则会有编译错误。

第二步、声明容器 Annotation 类型

容器 Annotation 必须有个数组类型的 value 元素。并且数组中各个元素的类型必须是可重复注释的类型。例如：

public @interface Schedules {
    Schedule[] value;
}

获取 Annotation

在 Java API 中提供了反射 API 来获取 Annotation。例如 AnnotatedElement.getAnnotationByType(Class)，这个方法返回一个 Annotatoin。但是如果一个元素上有多个重复 Annotation 的话，用这个方法只会返回容器 Annotation 中的第一个 Annotation。在 Java 8 中提供了更多的 API 来获取容器 Annotation 中的所有可重复注释，例如 AnnotatedElement.getAnnotations(Class) 等，可参看 Java API 获取更多这方面的信息。

文章来源：http://www.aptusource.org/2014/03/java-8-repeat-annotations/