Java 8 的 @Repeatable 注解需通过递归解析容器注解获取全部实例，先查容器再查自身，且容器必须正确定义 @Retention 和 @Target；仅用 getAnnotation() 会遗漏重复项。
Java 8 引入 @Repeatable 后，注解解析不能再只靠 getAnnotation(Class) 简单获取——它只返回一个实例，而重复注解实际以容器注解形式存储。要完整提取所有目标注解，必须实现递归或迭代的“展开”逻辑。
理解 @Repeatable 的底层机制
@Repeatable 并非语法糖，而是编译器强制约定：被标记的注解（如 @Role）必须声明一个 value() 方法，其返回类型为“容器注解”（如 @Roles），且该容器注解需用 @Retention 和 @Target 正确声明，并在其 value() 方法中返回原注解数组。
运行时，JVM 不会直接暴露重复的 @Role，而是将它们打包进 @Roles 实例中。因此解析器第一步是检查是否存在容器注解。
递归解析的核心逻辑
对任意注解类型 T，解析其所有重复实例需同时检查两类来源：
立即学习“Java免费学习笔记（深入）”；
- 直接获取
T注解（可能为null，因 JVM 可能只存容器） - 获取其容器注解
C，再从中提取T[]数组
由于容器注解本身也可能被 @Repeatable（虽然极少见，但语言允许），严格实现应递归处理容器；但实践中绝大多数场景只需一层展开。推荐采用“先查容器、再查自身”的安全顺序：
public static <T extends Annotation> List<T> getAllAnnotations(AnnotatedElement element, Class<T> annotationType) {
List<T> result = new ArrayList<>();
// 1. 尝试获取容器注解
Class<? extends Annotation> container = findContainerFor(annotationType);
if (container != null) {
Annotation containerAnn = element.getAnnotation(container);
if (containerAnn != null) {
Object array = getDeclaredMethod(containerAnn, "value").invoke(containerAnn);
if (array instanceof Annotation[]) {
for (Annotation ann : (Annotation[]) array) {
if (annotationType.isInstance(ann)) {
result.add((T) ann);
}
}
}
}
}
// 2. 再尝试直接获取单个注解（兼容非 @Repeatable 场景）
T single = element.getAnnotation(annotationType);
if (single != null) {
result.add(single);
}
return result;
}
自动发现容器注解的关键
不能硬编码容器类名。正确方式是读取目标注解类的 @Repeatable 元注解：
- 调用
annotationType.getAnnotation(Repeatable.class) - 若不为
null，则其value()即容器类型 - 注意：必须确保该容器注解的
value()方法签名与规范一致（返回T[]）
若容器注解未正确定义（如缺少 @Retention(RetentionPolicy.RUNTIME)），运行时将无法通过反射读取，此时重复注解实际不可见——这不是解析器问题，而是使用方配置错误。
避免常见陷阱
-
不要仅依赖
getAnnotations()遍历：它返回的是所有已声明注解实例，但重复注解在字节码中不作为独立条目存在，遍历时不会出现多个@Role -
区分
TYPE和TYPE_USE目标：容器注解的@Target必须包含被注解元素的类型（如类上用@Role，则容器@Roles的@Target至少含ElementType.TYPE） -
泛型擦除不影响解析：容器的
value()方法返回T[]，反射获取时是原始数组类型，强转安全
