@repeatable 注解允许在同一位置多次声明同类型注解，底层通过容器注解实现；需配套定义满足三条件的容器注解，并用 getannotationsbytype() 安全获取重复实例。
Java 8 引入 @Repeatable 注解，让同一位置多次声明同类型注解成为可能，但底层仍通过容器注解（container annotation）实现。理解其机制和正确使用方式，是避免反射获取失败、编译报错或语义混乱的关键。
为什么需要 @Repeatable？
在 Java 8 之前，若想在同一元素上表达多个同类语义（如多个权限规则、多个路径映射），只能靠“伪数组”形式——定义一个注解数组字段，再用单个注解包裹它们。这导致调用方必须写成 @Permissions({@Permission("read"), @Permission("write")})，语法冗长且不直观。@Repeatable 解决了这个问题，允许直接写成：
@Permission("read")@Permission("write")
编译器自动将它们收集到一个隐式容器注解中，对开发者透明。
@Repeatable 的必要配套：容器注解
使用 @Repeatable 时，必须同时定义一个“容器注解”（container annotation），它需满足三个条件：
- 必须声明为
@Retention和@Target与被标记注解一致（通常继承） - 必须只有一个名为
value的元素，类型为被标记注解的数组（如Permission[] value()） - 必须用
@Repeatable(PermissionContainer.class)指向自身（即容器类）
例如：@Repeatable(Permissions.class) 的 Permission 注解，必须对应一个 Permissions 容器注解，且其 value() 返回 Permission[]。
运行时如何安全获取重复注解？
反射 API 提供了专门方法处理重复注解，不能简单用 getAnnotation(Class) —— 它只返回第一个或 null（因实际存储的是容器）。应优先使用：
-
getAnnotationsByType(Permission.class)：返回所有匹配的重复注解实例（推荐） -
getAnnotation(Permissions.class)：手动取容器，再调用.value()获取数组（兼容旧代码，但多一层间接）
注意：getAnnotationsByType 是 Java 8+ 新增方法，支持重复注解的“逻辑展开”，而 getAnnotations() 返回的是底层容器注解（可能看不到单个 @Permission 实例）。
数组转换不是必需步骤，而是兼容性过渡手段
有些老框架或工具未适配 @Repeatable，仍期望接收注解数组。此时可手动从容器中提取：
Permission[] permissions = container.value();
但这只是临时适配，并非设计本意。新代码应直接面向 @Repeatable 注解本身，用 getAnnotationsByType 获取列表，更简洁、语义更清晰。强行转数组反而掩盖了重复注解的原生能力。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
