Java8注解

1. 目录

• 1.目录
• 2.元注解
• 3.@Retention
  • 实例
  • 说明
• 4.@Documented
  • 实例
• 5.@Target
  • 实例
  • 说明
• 6.@Inherited
  • 实例
  • 说明
• 7.@Repeatable
  • 实例
• 8.代码地址
• 9.系列导航

2. 元注解

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

3. @Retention

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

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

3.1 实例

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

3.2 说明

• RetentionPolicy.RUNTIME
  运行时注解应该是使用最多的。

• RetentionPolicy.SOURCE
  一般用于编译时注解的定义，比如 lombok 相关的注解。

4. @Documented

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

实例

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

5. @Target

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

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

---

5.1 实例

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

5.2 说明

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

6. @Inherited

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

实例

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

说明

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

7. @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() {
      }
  }

8. 代码地址

annotation metadata
系列导航

原文：https://blog.csdn.net/ryo1060732496/article/details/80891093