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

核心提示： 清单 6 中的 GroupTODO 注释类型中添加了几个新的变量，因为该注释类型的成员变量不是一个，Tiger 中的注释，第 2 部分: 定制注释(4)，所以将一个变量命名为 value 没有任何意义，只要成员变量多于一个，只不过是词法上的变异，清单 7 给出了一个具体应用中的 GroupTOD

清单 6 中的 GroupTODO 注释类型中添加了几个新的变量。因为该注释类型的成员变量不是一个，所以将一个变量命名为 value 没有任何意义。只要成员变量多于一个，就应该尽可能准确地为其命名。因为不可能从 清单 5所示的简写形式中获益，所以您需要创建虽然稍微有点冗长，但是更容易理解的注释类型。

清单 6 中出现的另一个新特性是注释类型定义了自己的枚举（枚举，即 enumeration，通常也称为 enums，是 Java 5 的另一个新特性。它并没有多么地不同凡响，对注释类型更是如此）。然后，清单 6 使用新定义的枚举作为一个成员变量的类型。

最后，再回到我们的主题 —— 默认值。建立默认值的过程非常琐碎，需要在成员声明的后面添加关键字 default ，然后提供默认值。正如您所料，默认值的类型必须与成员变量声明的类型完全相同。同样，这也不是什么火箭科学，只不过是词法上的变异。清单 7 给出了一个具体应用中的 GroupTODO 注释，其中 没有 指定 severity 成员：

清单 7. 使用默认值
　@com.oreilly.tiger.ch06.InProgress　
　@GroupTODO(　
　　item="Figure　out　the　amount　of　interest　per　month",　
　　assignedTo="Brett　McLaughlin",　
　　dateAssigned="08/04/2004"　
　)　
　public　void　calculateInterest(float　amount,　float　rate)　{　
　　//　Need　to　finish　this　method　later　
　}　

清单 8 中使用了同一个注释，但这一次给出了 severity 的值：

清单 8. 改写默认值
　@com.oreilly.tiger.ch06.InProgress　
　@GroupTODO(　
　　severity=GroupTODO.Severity.DOCUMENTATION,　
　　item="Need　to　explain　how　this　rather　unusual　method　works",　
　　assignedTo="Jon　Stevens",　
　　dateAssigned="07/30/2004"　
　)　
　public　void　reallyConfusingMethod(int　codePoint)　{　
　　//　Really　weird　code　implementation　
　}