j*a重复注解如何实现

发布时间：2025-12-16

点击量：

J*a 8起支持重复注解，需用@Repeatable标注目标注解并指向容器注解；容器注解必须是仅含value元素的注解，其类型为目标注解数组，且@Target和@Retention需兼容。

java重复注解如何实现

J*a 重复注解（Repeatable Annotations）从 J*a 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 需与目标注解兼容（一般完全一致）。

立即学习“J*a免费学习笔记（深入）”；

Gaga

曹越团队开发的AI视频生成工具

1151 查看详情 Gaga

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Actions {
    Action[] value();
}

在代码中使用重复注解

定义好后，可直接在同一位置多次使用 @Action，编译器会自动将其包装进 @Actions 容器中。

public class Service {
    @Action("s*e")
    @Action(value = "update", type = "db")
    @Action(type = "log")
    public void process() { }
}

运行时可通过反射获取：先尝试取 @Actions，若不存在再取单个 @Action（J*a 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() 方法签名和元注解一致性。

以上就是j*a重复注解如何实现的详细内容，更多请关注其它相关文章！

上一篇：j*ascript如何实现数据结构_链表和二叉树如何实现

下一篇：html5如何合并表单_HTML5多表单数据合并提交步骤【表