ASM 5.0.3 主要类的关系和简单实例

ASM包括主要三个类：

1、ClassReader : 负责从类文件中读取输入流，并依照固定的顺序调用 ClassVisitor 中声明的多个 visitorXxx的方法。

2、ClassVisitor : 抽象类，负责类内容的访问。

3、ClassWriter ：负责生成byte[]字节流。ClassWriter是ClassVisitor的子类。

三者的依赖关系和继承关系如下图：

下面是一个例子

一、首先定义一个ClassVisitor的子类ClassPrinter，用于显示一个需要处理的类的信息。

 
package org.soachina;

import static org.objectweb.asm.Opcodes.ASM4;

import org.objectweb.asm.AnnotationVisitor;
import org.objectweb.asm.Attribute;
import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.FieldVisitor;
import org.objectweb.asm.MethodVisitor;

public class ClassPrinter extends ClassVisitor {

	public ClassPrinter() {
		super(ASM4);
	}

	public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) {
		System.out.println(name + " extends " + superName + " {");
	}

	public void visitSource(String source, String debug) {
	}

	public void visitOuterClass(String owner, String name, String desc) {
	}

	public AnnotationVisitor visitAnnotation(String desc, boolean visible) {
		return null;
	}

	public void visitAttribute(Attribute attr) {
	}

	public void visitInnerClass(String name, String outerName, String innerName, int access) {
	}

	public FieldVisitor visitField(int access, String name, String desc, String signature, Object value) {
		System.out.println("    " + desc + " " + name);
		return null;
	}

	public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) {
		System.out.println("    " + name + desc);
		return null;
	}

	public void visitEnd() {
		System.out.println("}");
	}
}
 

二、创建ClassReader实例，并将ClassVisitor的子类 ClassPrinter传给ClassReader

   
package org.soachina;

import java.io.IOException;

import org.objectweb.asm.ClassReader;

public class ClassPrinterTest {

	public static void main(String args[]) throws IOException {
		ClassReader classReader = new ClassReader("java.lang.Runnable");
		ClassPrinter cp = new ClassPrinter();
		classReader.accept(cp, 0);
	}
}
   

三、ClassReader会按照以下顺序和约束调用 ClassPrinter中的方法，并传递相应的参数

 
visit ：必须有这个方法，第一个被调用。

visitSource：可选，如果有最多只能有一个。
visitOuterClass ：可选，如果有最多只能有一个。

visitAnnotation  可选，任意多个，与 visitAttribute  顺序可以互换
visitAttribute   可选，任意多个

visitInnerClass  可选，任意多个，与 visitField 、visitMethod 顺序可以互换
visitField             可选，任意多个
visitMethod      可选，任意多个

visitEnd  必须有这个方法，最后被调用。