注解(Annontion)是Java5开始引入的新特征。它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。

1、元注解

      元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型,它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解有以下几种:

  • @Target
  • @Retention
  • @Documented
  • @Inherited

   1.1 @Target

    用于描述注解的范围,即注解在哪用。它说明了Annotation所修饰的对象范围.取值类型(ElementType)有以下几种:

        1. TYPE 类、接口(包括注解类型) 或enum声明

        2. FIELD 字段声明(包括枚举常量)

        3. METHOD 方法声明

        4. PARAMETER 参数声明

        5. CONSTRUCTOR  构造函数声明

        6. LOCAL_VARIABLE  局部变量声明

        7. ANNOTATION_TYPE 注释类型声明

        8. PACKAGE   包声明

        9. TYPE_PARAMETER 类型参数声明

        10. TYPE_USE 类型的使用

        11. MODULE 模块声明

  1.2 @Retention

  用于描述注解的生命周期,表示需要在什么级别保存该注解,即保留的时间长短。取值类型(RetentionPolicy)有以下几种:

      1. SOURCE:在源文件中有效(即源文件保留)

      2.CLASS:在class文件中有效(即class保留)

      3.RUNTIME:在运行时有效(即运行时保留)

  1.3 @Documented

  用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。它是一个标记注解,没有成员。

  1.4 @Inherited

  用于表示某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。