Java 8起支持重复注解，需用@Repeatable标注目标注解并指向容器注解；容器注解必须是仅含value元素的注解，其类型为目标注解数组，且@Target和@Retention需兼容。
Java 重复注解（Repeatable Annotations）从 Java 8 开始支持，允许在同一个声明或表达式上多次使用同一个注解类型。要实现它，**核心是定义一个“容器注解”并用 @Repeatable 标明目标注解可重复**。
定义可重复的注解类型
被重复使用的注解必须标注 @Repeatable，且其值必须指向一个**容器注解类型**（必须是注解，且只有一个名为 value 的元素，类型为该注解类型的数组）。
- 容器注解的
value元素必须是目标注解类型的数组 - 容器注解本身可以有其他元注解（如
@Retention、@Target），但通常保持与目标注解一致
示例：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(Actions.class) // 指向容器注解
public @interface Action {
String value() default "";
String type() default "default";
}
定义对应的容器注解
容器注解必须满足：是一个注解；只有一个 value 元素；返回类型是目标注解的数组；@Target 和 @Retention 需与目标注解兼容（一般完全一致）。
立即学习“Java免费学习笔记（深入）”；
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Actions {
Action[] value();
}
在代码中使用重复注解
定义好后，可直接在同一位置多次使用 @Action，编译器会自动将其包装进 @Actions 容器中。
public class Service {
@Action("save")
@Action(value = "update", type = "db")
@Action(type = "log")
public void process() { }
}
运行时可通过反射获取：先尝试取 @Actions，若不存在再取单个 @Action（Java 8+ 会自动处理，推荐统一用 getAnnotationsByType(Action.class)）。
- 正确方式（推荐）：
method.getAnnotationsByType(Action.class)—— 自动合并容器内和独立的注解 - 不推荐：
method.getAnnotation(Actions.class)或method.getAnnotation(Action.class)，需手动处理兼容性
注意事项与常见问题
重复注解不是语法糖，而是编译器和反射 API 协同支持的机制。几个关键点：
- 容器注解名无强制规范，但建议用复数形式（如
Actions、Roles） - 不能同时显式写
@Action和@Actions({@Action,...})，否则编译报错 - 如果只写一次
@Action，运行时仍能通过getAnnotationsByType正常获取 - 容器注解本身不可被重复使用（即不能给一个方法加两个
@Actions）
基本上就这些。不复杂但容易忽略容器注解的约束条件，尤其是 value() 方法签名和元注解一致性。
