@Repeatable的作用以及具体如何使用

1. 前言

1. 最近无意看到某些注解上有@Repeatable，出于比较好奇，因此稍微研究并写下此文章。

2. 先说结论

1. @Repeatable的作用：使被他注释的注解可以在同一个地方重复使用。

2. 具体使用如下：

   @Target(ElementType.METHOD)
   @Retention(RetentionPolicy.RUNTIME)
   @Repeatable(value = MyAnnotationList.class)
   public @interface MyAnnotation {
       String name();
   }
   
   @Target(ElementType.METHOD)
   @Retention(RetentionPolicy.RUNTIME)
   public @interface MyAnnotationList {
   	// 被 @Repeatable引用的注解中，必须得有被 @Repeatable注释的注解（@MyAnnotation）返回类型的value方法
       MyAnnotation[] value();
   }
   
   public class MyAnnotationTest {
   
   	@MyAnnotation(name = "Test1")
   	@MyAnnotation(name = "Test2")
   	private void testMethod() {
   
       }
   
   	@MyAnnotationList(value = {@MyAnnotation(name = "Test1"), @MyAnnotation(name = "Test2")})
   	private void testMethod2() {
   
   	}
   }
   

3. 案例演示

1. 先定义新注解

   @Target(ElementType.METHOD)
   @Retention(RetentionPolicy.RUNTIME)
   public @interface MyAnnotation {
       String name();
   }
   

2. 创建新类并使用自定义注解

   public class MyAnnotationTest {
   
       @MyAnnotation(name = "Test1")
       private void testMethod(){
   
       }
   }
   

3. 当注解@MyAnnotation还没被@Repeatable注释的时候，在testMethod()方法上使用多次，会出现下面报错：
   
   将会提示：@MyAnnotation没被@Repeatable注解，无法重复使用@MyAnnotation

4. 因此在@MyAnnotation上使用@MyAnnotation，如下：
   
   @Repeatable(value = MyAnnotationList.class) 中引用了 @MyAnnotationList注解，用于@MyAnnotation注解上，有如下几个细节：

   1. 细节一：在引用注解上的@MyAnnotationList的方法中得有value()方法，如下：
      

   2. 细节二：在引用注解上的@MyAnnotationList的方法中得有【被@Repeatable注解的@MyAnnotation注解类型的数组返回值的value方法】
      

   3. 细节三：该案例中，若在方法上重复使用@MyAnnotation注解，实际上也会在运行的时候被包装成MyAnnotationList[] 里面，如下：
      

   4. 细节四：@MyAnnotation可多次使用，但不可多次与@MyAnnotationList一起使用，如下：
      

   5. 细节五：@MyAnnotation可多次使用，但仅可一个与@MyAnnotationList一起使用，但唯一的@MyAnnotation在运行的时候没被包装成MyAnnotationList[] 里面，如下：