class.getannotationsbytype可直接获取所有@repeatable注解实例组成的数组，无需手动遍历容器；需正确定义容器注解（含value()方法返回目标注解数组）、保持retention与target兼容；该方法返回扁平化数组，合并独立声明与容器内注解，且要求注解具有runtime保留策略和匹配的target。
Java 中 Class.getAnnotationsByType 可以直接读取 @Repeatable 注解的**所有实例组成的数组**，无需手动遍历容器注解，前提是重复注解的“容器类型”已正确定义且满足规范。
必须定义合法的 @Repeatable 容器注解
要让 getAnnotationsByType 正确聚合重复注解，需同时满足：
- 目标注解（如
@Role）用@Repeatable(Container.class)声明，其中Container是其容器注解类型 - 容器注解（如
@Roles）本身必须是注解类型，且唯一成员为value()，返回目标注解类型的数组（如Role[] value();） - 容器注解的
@Retention和@Target必须与目标注解兼容（通常保持一致）
调用 getAnnotationsByType 返回的是“扁平化”的实际注解数组
该方法不会返回容器注解本身，而是自动提取容器中所有元素，并合并显式声明的独立注解，最终返回一个包含全部匹配注解实例的数组。例如：
@Role("admin")
@Role("user")
public class UserService { }
执行 UserService.class.getAnnotationsByType(Role.class) 将返回长度为 2 的 Role[]，两个元素分别对应 "admin" 和 "user"。
支持混合声明：独立注解 + 容器注解同时存在
若类上既直接标注了多个 @Role，又通过 @Roles 容器集中声明，getAnnotationsByType 会统一合并：
@Role("guest")
@Roles({@Role("admin"), @Role("editor")})
public class EditorService { }
此时 getAnnotationsByType(Role.class) 返回长度为 3 的数组，顺序按源码中出现顺序（JVM 规范不保证绝对顺序，但主流 JDK 实现按声明先后）。
注意运行时可见性（Retention）和作用目标（Target）
只有当注解声明了 @Retention(RetentionPolicy.RUNTIME)，且其 @Target 允许标注在类（如 ElementType.TYPE）上时，getAnnotationsByType 才能在运行时获取到。否则返回空数组。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
