Classworking 工具箱: 注释（Annotation）与 ASM

对于清单 2 的示例，我选择在 toString() 输出中包含所有的字段，字段顺序与其在类中声明的顺序相同，并以“name=”文本来开始每个字段值，以在输出中标识它们。对于本例，文本是通过剥去用来标识成员字段的“m_”前缀，来直接从字段名生成的。在其他情况下，我可能想要在输出中仅包含某些字段、更改顺序、更改用于值的标识符文本，或者甚至完全跳过标识符文本。注释格式灵活得足以表示所有的可能。

定义注释

可以以多种方式为 toString() 的生成定义注释。为使它真正有用，我情愿最小化所需的注释数目，可能通过使用类注释来标志我想要在其中生成方法的类，并使用单个的字段注释来重写字段的默认处理。这并不太难做到，但是实现代码将变得相当复杂。对于本文来说，我想使它保持简单，因此只使用包含在实例的描述中的单个字段的注释。

我想要控制的因素有：要包含哪些字段，字段值是否有前导文本，该文本是否基于字段名，以及字段在输出中的顺序。清单 3 给出了一个针对该目的的基本注释：

清单 3. toString() 生成的注释

package　com.sosnoski.asm;　
import　java.lang.annotation.ElementType;　
import　java.lang.annotation.Target;　
@Target({ElementType.FIELD})　
public　@interface　ToString　{　
　　int　order()　default　0;　
　　String　text()　default　"";　
}　

清单 3 的注释只定义了一对命名值，给出了顺序和用于一个字段的前导文本。我已经用 @Target 行将该注释的使用限定到字段声明。我还为每个值定义了默认值。这些默认值并不应用于成为二进制类表示的生成的注释信息（只有当注释在运行时作为伪接口被访问时，它们才应用，而我不会这么做），所以我实际上并不关心使用什么值。我只是通过定义默认值，使值是可选的，而不必在每次使用注释时都指定它们。