在某些情况下，您希望将相同的注解应用于声明或类型。从Java SE 8发行版开始，重复注解使您可以执行此操作。

例如，您正在编写代码以使用计时器服务，该服务使您能够在给定时间或某个时间表上运行方法，与UNIX `cron`服务类似。现在，您想设置一个计时器，在每月的最后一天以及每个星期五的晚上11点运行方法`doPeriodicCleanup`。要设置计时器运行，请创建`@Schedule`注解并将其应用两次到`doPeriodicCleanup`方法。第一次使用指定了月份的最后一天，第二次使用指定了星期五的下午11点，如以下代码示例所示：

```java

@Schedule(dayOfMonth="last")

@Schedule(dayOfWeek="Fri", hour="23")

public void doPeriodicCleanup() { ... }

```

前面的示例将注解应用于方法。您可以在任何使用标准注解的地方使用重复注解。例如，您有一个处理未授权访问异常的类。您使用一个`@Alert`注解为管理员注册类，另一个注册给管理员：

```java

@Alert(role="Manager")

@Alert(role="Administrator")

public class UnauthorizedAccessException extends SecurityException { ... }

```

出于兼容性原因，重复注解存储在由Java编译器自动生成的*容器注解*(container annotation)中。为了让编译器执行此操作，代码中需要两个声明。

**Step 1: 声明一个可重复注解类型**

-

注解类型必须用`@Repeatable`元注解标记。以下示例定义了一个自定义`@Schedule`可重复注解类型：

```java

import java.lang.annotation.Repeatable;

@Repeatable(Schedules.class)

public @interface Schedule {

String dayOfMonth() default "first";

String dayOfWeek() default "Mon";

int hour() default 12;

}

```

圆括号中的`@Repeatable`元注释的值是Java编译器为存储重复注解而生成的容器注解的类型。在此示例中，包含的注解类型是`Schedules`，因此重复的`@Schedule`注解存储在`@Schedules`注解中。

在声明中应用相同的注解而不首先声明它是可重复的，将导致编译时错误。

**Step 2: 声明包含注解类型**

-

包含注解类型必须具有数组类型的`value `元素。数组类型的组件类型必须是可重复的注解类型。包含注释类型的`Schedules `声明如下：

```java

public @interface Schedules {

Schedule[] value();

}

```

**检索注解**

-

Reflection API中有几种可用于检索注解的方法。返回单个注解(如[`AnnotatedElement.getAnnotation(Class )`](https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/AnnotatedElement.html#getAnnotation-java.lang.Class-))的方法的行为不会发生变化，因为它们只会在请求类型的注解存在时返回单个注解。如果存在多个请求类型的注解，您可以通过首先获取它们的容器注解来获取它们。通过这种方式，遗留代码继续工作。在Java SE 8中引入了其他方法，这些方法扫描容器注解以一次返回多个注解，例如[`AnnotatedElement.getAnnotationsByType(Class `)](https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/AnnotatedElement.html#getAnnotationsByType-java.lang.Class-)。有关所有可用方法的信息，请参阅[`AnnotatedElement`](https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/AnnotatedElement.html)类规范。

**设计注意事项**

-

设计注解类型时，必须考虑该类型注解的基数。现在可以使用同一个注解一次或零次，或者，如果注解的类型被标记为`@Repeatable`，则可以多次使用。也可以通过使用`@Target`元注解来限制注解类型的使用位置。例如，您可以创建只能在方法和字段上使用的可重复注解类型。仔细设计注解类型非常重要，以确保使用注解的程序员发现它尽可能灵活和强大。