当前位置: 代码迷 >> 综合 >> 深入浅出 java 注解-03-java 元注解 @Retention、@Documented、@Target、@Inherited、@Repeatable
  详细解决方案

深入浅出 java 注解-03-java 元注解 @Retention、@Documented、@Target、@Inherited、@Repeatable

热度:44   发布时间:2024-01-06 11:06:23.0

目录

  • 目录
  • 元注解
  • @Retention
    • 实例
    • 说明
  • @Documented
    • 实例
  • @Target
    • 实例
    • 说明
  • @Inherited
    • 实例
    • 说明
  • @Repeatable
    • 实例
  • 代码地址
  • 系列导航

元注解

适用于其他注释的注释称为元注释。在 java.lang.annotation 中定义了几个元注释类型。

@Retention

指定标记的注解如何存储:

属性 说明
RetentionPolicy.SOURCE 标记的注释只保留在源层中,编译器将忽略它。
RetentionPolicy.CLASS 编译器在编译时保留标记的注释,但是Java虚拟机(JVM)会忽略它。
RetentionPolicy.RUNTIME 标记的注释由JVM保留,以便运行时环境可以使用它。

实例

@Retention(RetentionPolicy.RUNTIME)
public @interface MetadataDemo {
    
}

说明

  • RetentionPolicy.RUNTIME

运行时注解应该是使用最多的。

  • RetentionPolicy.SOURCE

一般用于编译时注解的定义,比如 lombok 相关的注解。

@Documented

@Documented 注解表明,无论何时使用指定的注释,都应该使用Javadoc工具对这些元素进行文档化。
(默认情况下,注释不包含在Javadoc中。)有关更多信息,请参见Javadoc工具页。

实例

@Retention(RetentionPolicy.CLASS)
@Documented
public @interface MetadataDemo {
    
}

@Target

@Target批注标记另一个批注,以限制批注可以应用于何种Java元素。目标注释指定以下元素类型之一作为其值:

属性 说明
ElementType.ANNOTATION_TYPE 应用于注解类型
ElementType.CONSTRUCTOR 可以应用于构造函数
ElementType.FIELD 可以应用于字段或属性。
ElementType.LOCAL_VARIABLE 可以应用于一个局部变量
ElementType.METHOD 可以应用于方法级注释
ElementType.PACKAGE 应用于包声明
ElementType.PARAMETER 应用于方法的参数
ElementType.TYPE 应用于类的任何元素

实例

@Retention(RetentionPolicy.CLASS)
@Documented
@Target(ElementType.METHOD)
public @interface MetadataDemo {
    
}

说明

指定我们注解的应用范围非常重要。一般最常用的是 ElementType.TYPEElementType.METHOD

@Inherited

@Inherited 表明注解类型可以从超类继承。(这在默认情况下是不对的。)
当用户查询注释类型而该类没有对此类型的注释时,将查询类的超类以获取注释类型。此注释仅应用于类声明。

实例

@Retention(RetentionPolicy.CLASS)
@Documented
@Target(ElementType.METHOD)
@Inherited
public @interface MetadataDemo {
    
}

说明

当一个类继承了拥有此注解的类时,即使当前类没有任何注解。
只要父类的注解拥有(@Inherited)属性,则在子类中可以获取到此注解。

@Repeatable

在Java SE 8中引入的 @Repeatable 注解表明标记的注解可以多次应用于相同的声明或类型使用。
有关更多信息,请参见重复注释。

实例

  • Repeats.java
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Repeats {
    Repeat[] value();
}
  • Repeat.java
@Repeatable(value = Repeats.class)
public @interface Repeat {
    String value();
}
  • RepeatDemo.java
public class RepeatDemo {
    @Repeat(value = "tag")@Repeat(value = "tag2")public void method() {}}

代码地址

annotation metadata

系列导航

系列导航

  相关解决方案