Annotation

Use

• 给compiler提供信息，用来检测错误,如@override
• 在编译期，一些工具（如apt)可以通过Annotation信息来生成一些代码
• 在运行期间，可以用来检测,如@NonNull

Declaring an Annotation Type

For Example:

先定义Annotation:

@interface ClassPreamble {
   String author();
   String date();
   int currentRevision() default 1;
   String lastModified() default "N/A";
   String lastModifiedBy() default "N/A";
   // Note use of array
   String[] reviewers();
}

使用：

@ClassPreamble (
   author = "John Doe",
   date = "3/17/2002",
   currentRevision = 6,
   lastModified = "4/12/2004",
   lastModifiedBy = "Jane Doe",
   // Note array notation
   reviewers = {"Alice", "Bob", "Cindy"}
)

Predefined Annotation Types

Annotation Types Used by the Java Language

下面三个Annotation在java.lang中被定义

• @Deprecated 标记的元素是不推荐使用的，使用会产生warning。如果声明了@Deprecated，应该给出弃用的理由以及用什么替代
• @SuppressWarnings 不产生warning
• @Override

Annotations That Apply to Other Annotations

下面的Annotations在java.lang.annotation被定义，用来“修饰”其他Annotation。

• @Rentation 指示被其修饰的Annotation如何被存储：
  • Source:被compiler忽略，只保留在Java Source Code这个层面
  • Class:在编译期被保留，被JVM忽略
  • Runtime:在运行期被保留
• @Target 表明被其修饰的Annotation作用的区域，有Method、Type、CONSTRUCTOR