1.3 ASM-简介-结构
本文可转载演绎,但需要注明原作者和本文链接。
1.3 结构
ASM库是由几个分布在不同jar包中的package组成的:
- org.objectweb.asm和org.objectweb.asm.signature包定义了基于event访问的API,并且提供了class的parser和writer组件。这些package在asm.jar中。
- 在asm-util.jar中的org.objectweb.asm.util包,提供了基于核心的API的不同工具类,可以用于开发或者调试ASM应用。
- org.objectweb.asm.commons 提供了一些预定义的class转换器(transformer),这些转换器大多都是基于核心API开发的。这个package在asm-commons.jar中。
- 在asm-tree.jar中的org.objectweb.asm.tree包,定义了基于object访问的API,并且提供了基于event的访问方式和基于object的访问方式。
- 在org.objectweb.asm.tree.analysis提供了一个class的analysis框架,以及一些基于tree API的预定义analyzer。这个package在asm-analysis.jar中。
本部文档由两部分组成。第一部分涵盖了核心API,即asm、asm-util、asm-commons包。
第二部分涵盖了tree API,即asm-tree、asm-analysis包。
每一部分至少有一章介绍class相关的API,一章介绍method相关的API,一章介绍注解、类属性(FIXME generic types)相关的API等等。
每一章都会介绍编程接口,相关的工具和预定义的组件。
事例(example)的源码可以在ASM官网下载。
本文的结构可以更容易的逐步介绍class文件的特征(feature),但是有时需要将一个ASM类分散在几个部分中展示。
因此建议顺序阅读本文档。
有关ASM API的参考文档,请阅读响应的javadoc。
印刷体约定
斜体 用于强调句子中的要素.
恒定宽度用于代码片段。
粗体用于强调代码元素。
斜体恒定等宽 用于在代码和标签中的变量部分。
1.4 致谢
感谢François Horn的宝贵意见,极大的提高的本书的结构性和可读性。