Java基础元注解基本原理示例详解

目录

元注解

是负责对其它注解进行说明的注解，自定义注解时可以使用元注解。Java>@Documented、@Target、@Retention 和 @Inherited。Java 8 又增加了 @Repeatable 和 @Native 两个注解。这些注解都可以在 java.lang.annotation 包中找到。下面主要介绍每个元注解的作用及使用。

@Documented

@Documented>

IDEA>

Tools -> Generate JavaDoc

@Target

@Target>

@Retention

@Retention>java.lang.annotation.RetentionPolicy 枚举类型。

RetentionPolicy 有 3 个枚举常量，如下所示：

SOURCE：在源文件中有效（即源文件保留）；CLASS：在 class 文件中有效（即 class 保留）；RUNTIME：在运行时有效（即运行时保留）；

生命周期大小排序为 SOURCE < CLASS < RUNTIME，前者能使用的地方后者一定也能使用。

如果需要在运行时去动态获取注解信息，那只能用 RUNTIME 注解，如 @Documented 注解；如果要在编译时进行一些预处理操作，比如生成一些辅助代码，就用 CLASS 注解，如 @NonNull 注解；如果只是做一些检查性的操作，则可选用 SOURCE 注解，如 @Override 和 @SuppressWarnings 注解。

@Inherited

@Inherited>

示例

创建一个自定义注解，代码如下所示：

@Target({ ElementType.TYPE })
@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface MyInherited {
}

测试类代码如下：

@MyInherited
public class TestA {
    public static void main(String[] args) {
        System.out.println(TestA.class.getAnnotation(MyInherited.class));
        System.out.println(TestB.class.getAnnotation(MyInherited.class));
        System.out.println(TestC.class.getAnnotation(MyInherited.class));
    }
}
class TestB extends TestA {
}
class TestC extends TestB {
}

运行结果为：

@MyInherited()
@MyInherited()
@MyInherited()

@Repeatable

@Repeatable>

示例

Java>

public @interface Roles {
    Role[] roles();
}
public @interface Role {
    String roleName();
}
public class RoleTest {
    @Roles(roles = {@Role(roleName = "roleA"), @Role(roleName = "roleB")})
    public String doString(){
        return "MingYue Repeatable 测试";
    }
}

Java 8 之后增加了重复注解，使用方式如下：

public @interface Roles {
    Role[] value();
}
@Repeatable(Roles.class)
public @interface Role {
    String roleName();
}
public class RoleTest {
    @Role(roleName = "roleA")
    @Role(roleName = "roleB")
    public String doString(){
        return "MingYue Repeatable 测试";
    }
}

两者不同的地方是，创建重复注解 Role 时加上了 @Repeatable 注解，指向存储注解 Roles，这样在使用时就可以直接重复使用 Role 注解。

@Native

@Native>

以上就是Java基础元注解基本原理示例详解的详细内容，更多关于Java 元注解的资料请关注易采站长站其它相关文章！