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

作者:九七年生于初夏 时间:2022-08-09 23:21:16 

元注解

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

@Documented

@Documented 是一个标记注解,没有成员变量。用 @Documented 注解修饰的注解类会被 JavaDoc 工具提取成文档。默认情况下,JavaDoc 是不包括注解的,但如果声明注解时指定了 @Documented,就会被 JavaDoc 之类的工具处理,所以注解类型信息就会被包括在生成的帮助文档中。

IDEA Documented 文档生成

Tools -> Generate JavaDoc

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

@Target

@Target 注解用来指定一个注解的使用范围,即被 @Target 修饰的注解可以用在什么地方。@Target 注解有一个成员变量(value)用来设置适用目标,value 是 java.lang.annotation.ElementType 枚举类型的数组,下表为 ElementType 常用的枚举常量。

类型适用目标
TYPE用于类、接口(包括注解类型)或 enum 声明
FIELD用于成员变量(包括枚举常量)
METHOD用于方法
PARAMETER用于方法参数
CONSTRUCTOR用于构造器
LOCAL_VARIABLE用于局部变量
ANNOTATION_TYPE用于注解
PACKAGE用于包
TYPE_PARAMETER用来类型参数(JDK 1.8新增)
TYPE_USE能标注任何类型名称(JDK 1.8新增)

@Retention

@Retention 描述注解的生命周期,也就是该注解被保留的时间长短。@Retention 注解中的成员变量(value)用来设置保留策略,value 是 java.lang.annotation.RetentionPolicy 枚举类型。

RetentionPolicy 有 3 个枚举常量,如下所示:

  • SOURCE:在源文件中有效(即源文件保留);

  • CLASS:在 class 文件中有效(即 class 保留);

  • RUNTIME:在运行时有效(即运行时保留);

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

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

@Inherited

@Inherited 是一个标记注解,用来指定该注解可以被继承。使用 @Inherited 注解的 Class 类,表示这个注解可以被用于该 Class 类的子类。就是说如果某个类使用了被 @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 8 新增,它允许在相同的程序元素中重复注解,在需要对同一种注解多次使用时,往往需要借助该注解。Java 8 版本以前,同一个程序元素前最多只能有一个相同类型的注解,如果需要在同一个元素前使用多个相同类型的注解,则必须使用注解&ldquo;容器&rdquo;。

示例

Java 8 之前的相同类型的注解做法:

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 注解修饰成员变量,则表示这个变量可以被本地代码引用,常常被代码生成工具使用。

来源:https://juejin.cn/post/7189219351164092471

标签:Java,元注解,基础原理
0
投稿

猜你喜欢

  • springboot cloud使用eureka整合分布式事务组件Seata 的方法

    2023-08-19 13:49:44
  • Java流处理stream使用详解

    2021-09-17 18:27:58
  • Spring JPA之save方法示例详解

    2023-09-06 15:50:35
  • java抓取网页或文件中的邮箱号码

    2023-07-30 19:19:28
  • iOS新浪微博、腾讯微博分享功能实例

    2023-06-16 09:15:53
  • Spring整合junit的配置过程图解

    2022-12-18 16:37:48
  • 浅谈Android开发中项目的文件结构及规范化部署建议

    2022-05-13 12:47:37
  • springboot使用redis实现从配置到实战

    2023-05-05 09:49:08
  • 详解java中String、StringBuilder、StringBuffer的区别

    2023-06-17 06:03:23
  • Java代码精简之道(推荐)

    2023-07-28 02:00:05
  • Spring注解@Configuration与@Bean注册组件的使用详解

    2022-09-13 01:52:56
  • Spring boot中@Conditional和spring boot的自动配置实例详解

    2023-06-20 09:36:14
  • Java IO文件后缀名过滤总结

    2021-09-01 23:36:47
  • jstorm源码解析之bolt异常处理方法

    2022-08-05 23:12:08
  • jsp+servlet实现简单登录页面功能(附demo)

    2023-09-24 11:32:28
  • 高并发下如何避免重复数据产生技巧

    2022-04-17 07:08:57
  • seata-1.4.0安装及在springcloud中使用详解

    2023-02-21 00:49:21
  • Flutter基于Dart Unwrapping Multiple Optional小技巧

    2023-07-05 11:44:19
  • flutter窗口初始和绘制流程详析

    2023-08-17 21:07:30
  • 详解Spring-boot中读取config配置文件的两种方式

    2021-07-04 15:52:55
  • asp之家 软件编程 m.aspxhome.com