java重复注解如何实现-java教程-PHP中文网

java重复注解如何实现

舞姬之光

发布： 2025-12-16 17:22:44

原创

721人浏览过

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

java重复注解如何实现

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免费学习笔记（深入）”；

Get笔记

Get笔记，一款AI驱动的知识管理产品

774

查看详情

@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)，需手动处理兼容性