Classworking工具箱: 注释（Annotation）与ASM - 编程入门网

清单 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 行将该注释的使用限定到字段声明。我还为每个值定义了默认值。这些默认值并不应用于成为二进制类表示的生成的注释信息（只有当注释在运行时作为伪接口被访问时，它们才应用，而我不会这么做），所以我实际上并不关心使用什么值。我只是通过定义默认值，使值是可选的，而不必在每次使用注释时都指定它们。

使用注释时要记住的一个因素是，命名值必须始终是编译时常量，而且不能为 null。该规则适用于默认值（如果指定的话）和由用户设置的值。我猜测这个决定是基于与早期 Java 语言定义的一致性而做出的，但是我觉得奇怪的是，对 Java 语言做出如此重大修改的规范，却只局限于这一方面的一致性。

实现生成

既然已经打好了基础，就该研究实现 classworking 转换了：当载入带注释的类时向它们添加 toString() 方法。该实现涉及三个单独的代码段：截获 classloading、访问注释信息和实际转换。

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

用 instrumentation 来截获

J2SE 5.0 给 Java 平台添加了许多特性。就我个人而言，我并不认为所有这些添加的特性都是改进。但是，有两个不太引人注意的新特性确实对 classworking 很有用，就是 java.lang.instrument 包和 JVM 接口，它们使您可以指定将在执行程序时使用的类转换代理，当然还有其他功能。

要使用转换代理，需要在启动 JVM 时指定代理类。当使用 java 命令来运行 JVM 时，可以使用命令行参数，以 -javaagent:jarpath[=options] 的形式来指定代理，其中“jarpath”是到包含代理类的 JAR 文件的路径，而“options”是代理的参数串。代理 JAR 文件使用一个特殊的清单属性来指定实际的代理类，这必须定义一个方法： public static void premain(String options, Instrumentation inst)。 该代理 premain() 方法将先于应用程序的 main() 方法调用，而且能够使用传入的 java.lang.instrument.Instrumentation 类实例注册实际的转换器。

该转换器类必须实现 java.lang.instrument.ClassFileTransformer 接口，后者定义了一个 transform() 方法。当使用 Instrumentation 类实例注册一个转换器实例时，将会为在 JVM 中创建的每个类调用该转换器实例。转换器将获得到二进制类表示的访问，并且可以在类表示被 JVM 加载之前修改它。

清单 4 给出了处理注释的代理和转换器类（在本例中是同一个类，但是这二者不一定要相同）实现。 transform() 实现使用 ASM 来扫描提供的二进制类表示，并寻找适当的注释，收集关于该类的带注释字段的信息。如果找到带注释的字段，该类将被修改以包含生成的 toString() 方法，而修改后的二进制表示将被返回。否则 transform() 方法只返回 null，表明没有必要进行修改。

清单 4. 代理和转换器类

package　com.sosnoski.asm; import　java.lang.instrument.ClassFileTransformer; import　java.lang.instrument.IllegalClassFormatException; import　java.lang.instrument.Instrumentation; import　java.security.ProtectionDomain; import　org.objectweb.asm.ClassReader; import　org.objectweb.asm.ClassWriter; public　class　ToStringAgent　imp

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!