java 8 的 @repeatable 注解支持同一位置重复使用，需定义带 @repeatable 的注解及其匹配的容器注解，运行时通过 getannotationsbytype 统一获取所有实例。
Java 8 引入了 @Repeatable，让同一个注解能在同一位置（如方法、类）上重复使用，而无需包裹在容器注解中——这是实现“优雅叠加”的核心机制。关键不在于写多少次注解，而在于设计好可重复注解及其容器。
1. 定义可重复注解本身
被 @Repeatable 标记的注解必须声明其“容器类型”。这个注解本身要满足：保留策略为 RetentionPolicy.RUNTIME，且目标（@Target）需与容器一致。
例如，定义一个用于标记接口幂等策略的注解：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(IdempotentStrategies.class) // 指向容器注解
public @interface IdempotentStrategy {
String value() default "";
String key() default "";
long expireSeconds() default 300;
}
2. 定义对应的容器注解
容器注解必须是数组类型，且元素类型必须是它所容纳的可重复注解；它的 @Target 和 @Retention 必须与被重复注解完全一致。
继续上面的例子：
一款AI工具，主要用于管理 OpenClaw 所使用的来自 OpenRouter 的免费 AI 模型。自动按质量对模型进行排序，配置回退机制以应对速率限制，并更新 opencla...，适合需要提升相关任务效率的用户。
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface IdempotentStrategies {
IdempotentStrategy[] value();
}
注意：容器名惯例是复数形式（如 Strategies），但不是强制要求；关键是 @Repeatable 的参数类型和容器中数组元素类型严格匹配。
3. 在方法上直接多次使用，无需手动包装
现在就可以在同一个方法上自然叠加多个 @IdempotentStrategy，编译器会自动聚合成 @IdempotentStrategies 实例：
public class OrderService {
@IdempotentStrategy(value = "ORDER_CREATE", key = "#order.id", expireSeconds = 600)
@IdempotentStrategy(value = "ORDER_PAY", key = "#order.payNo", expireSeconds = 1800)
public void processOrder(Order order) {
// ...
}
}
运行时通过反射获取该方法上的注解，直接调用 method.getAnnotation(IdempotentStrategies.class) 即可拿到所有声明的策略数组。
4. 反射读取时的兼容写法（推荐）
为避免手动判断是否使用了容器注解，应统一按“可重复注解”方式读取：
- 用
method.getAnnotationsByType(IdempotentStrategy.class)—— 这是首选，能自动合并显式声明和容器内声明，返回真实声明的全部实例数组； - 不要只依赖
getAnnotation(IdempotentStrategies.class)，否则会漏掉未显式使用容器、仅靠@Repeatable声明的场景； - 如果容器注解也存在（比如旧代码手动写了
@IdempotentStrategies({@IdempotentStrategy(...)})），getAnnotationsByType同样能正确解析并去重合并（实际不会重复，JVM 保证逻辑一致性）。
不复杂但容易忽略：容器注解不是“备用方案”，而是编译器生成的中间结构；真正提升表达力的是 @Repeatable + getAnnotationsByType 这组配合。写注解时聚焦语义，读注解时信任 JVM 的聚合能力。
