Java 8 的 @Repeatable 注解需配合容器注解使用，后者必须 @Retention(RUNTIME) 且含 value() 数组属性；获取时应优先用 getAnnotationsByType()，容器可扩展元数据用于分组或开关控制。
Java 8 引入 @Repeatable 后，单个元素上可重复声明同一注解，但原生不支持直接获取所有重复注解实例——必须通过“容器注解”中转。要让框架或自定义逻辑正确识别并聚合这些重复注解，关键在于容器注解的设计与反射调用方式的配合。
容器注解必须满足两个硬性条件
Java 规范强制要求：被 @Repeatable 标记的注解，其 value 属性必须返回一个数组类型，且该数组类型的注解（即容器注解）需满足：
- 必须声明为
@Retention(RetentionPolicy.RUNTIME)，否则运行时无法读取 - 必须定义一个名为
value的属性，类型为「被标记注解」的数组（如@interface MyRules { MyRule[] value(); }）
反射获取重复注解的两种等效写法
从 AnnotatedElement（如 Class、Method、Field）获取重复注解时，不能直接用 getAnnotation(MyRule.class)——它只返回第一个（或 null）。必须使用：
-
getAnnotationsByType(MyRule.class)：推荐方式，自动展开容器，返回所有@MyRule实例数组 -
getAnnotation(MyRules.class).value()：手动读取容器再取值，需先判空，且依赖容器存在
前者更健壮，后者在调试或需要显式访问容器元信息（如容器上的其他属性）时有用。
立即学习“Java免费学习笔记（深入）”；
容器注解可携带额外元数据，不止是“收纳盒”
容器注解不是透明中转层，它可以拥有自己的属性。例如：
@interface MyRules {
MyRule[] value();
String group() default "default"; // 自定义分组标识
boolean enabled() default true;
}
这样设计后，在解析规则时就能结合容器级配置做预过滤：
- 只处理
enabled == true的容器下的所有规则 - 按
group对规则分类执行，比如 “validation” 组 vs “audit” 组
避免常见陷阱：命名与继承冲突
容器注解名通常为复数形式（如 @Validations 容纳 @Validation），但 Java 不校验命名约定。真正重要的是：
- 容器注解的
value()类型必须严格匹配被重复注解的类类型，不能是父类或接口 - 若父类和子类都声明了相同重复注解，
getAnnotationsByType()默认只返回当前元素上的（不继承），需手动遍历类层次结构 - 不要在容器注解上误加
@Repeatable，会导致编译错误
