Tiger 中的注释，第 2 部分: 定制注释

核心提示：本系列的第一篇文章 介绍了什么是元数据，元数据的重要性，Tiger 中的注释，第 2 部分: 定制注释，以及如何使用 J2SE 5.0（也叫做 Tiger）的基本内置注释，如果习惯了这些概念，并确信其位于类路径中，那么您就可以在自己的源代码方法中使用它，您可能已经在想，Java 5 提供的三种标准注释也并不是特别健壮

本系列的第一篇文章 介绍了什么是元数据，元数据的重要性，以及如何使用 J2SE 5.0（也叫做 Tiger）的基本内置注释。如果习惯了这些概念，您可能已经在想，Java 5 提供的三种标准注释也并不是特别健壮，能使用的只有 Deprecated 、 SuppressWarnings 和 Override 而已。所幸的是，Tiger 还允许定义自己的注释类型。在本文中，我将通过一些示例引导您掌握这个相对简单的过程。您还将了解如何对自己的注释进行注解，以及这样做的一些好处。我要感谢 O'Reilly Media, Inc.，他们非常慷慨地允许我在本文中使用我关于 Tiger 的书籍的“注释”一章中的代码示例。

定义自己的注释类型

通过添加了一个小小的语法（Tiger 添加了大量的语法结构），Java 语言支持一种新的类型 —— 注释类型（annotation type）。注释类型看起来很像普通的类，但是有一些特有的性质。最明显的一点是，可以在类中以符号（ @ ）的形式注释其他 Java 代码。我将一步一步地介绍这个过程。

@interface 声明

定义新的注释类型与创建接口有很多类似之处，只不过 interface 关键字之前要有一个 @ 符号。清单 1 中给出的是一个最简单的注释类型的示例：
清单 1. 非常简单的注释类型

package　com.oreilly.tiger.ch06;　
/**　
　*　Marker　annotation　to　indicate　that　a　method　or　class　
　*　　is　still　in　progress.　
　*/　
public　@interface　InProgress　{　}　

清单 1 的含义非常明显。如果编译这个注释类型，并确信其位于类路径中，那么您就可以在自己的源代码方法中使用它，以指出某个方法或类仍在处理中，如清单 2 所示：