使用ASM,可以生成一个.class文件当中各个部分的内容。
public class HelloWorld {
public void test(String name, int age) {
String line = String.format("name = '%s', age = %d", name, age);
System.out.println(line);
}
}
在这里,我们只关心方法的部分:
- 对于方法头的部分,我们可以使用ClassVisitor.visitMethod(int access, String name, String descriptor, String signature, String[] exceptions)方法来提供。
- 其中的access参数提供访问标识信息,例如public
- 其中的name参数提供方法的名字,例如test
- 其中的descriptor参数提供方法的参数类型和返回值的类型
- 对于方法体的部分,我们可能通过使用MethodVisitor类来实现。
- 如何得到一个MethodVisitor对象呢?ClassVisitor.visitMethod()的返回值是一个MethodVisitor类型的实例。
- 方法体的instructions是如何添加的呢?通过调用MethodVisitor.visitXxxInsn()方法来提供的
对于MethodVisitor类来说,我们从两个方面来把握:
- 第一方面,就是MethodVisitor类的visitXxx()方法的调用顺序。
- 第二方面,就是MethodVisitor类的visitXxxInsn()方法具体有哪些。
注意:visitXxx()方法表示MethodVisitor类当中所有以visit开头的方法,包含的方法比较多;而visitXxxInsn()方法是visitXxx()方法当中的一小部分,包含的方法比较较少。
方法的调用顺序
MethodVisitor类的visitXxx()方法要遵循一定的调用顺序:
[
visitCode
(
visitFrame |
visitXxxInsn |
visitLabel |
visitTryCatchBlock
)*
visitMaxs
]
visitEnd
这些方法的调用顺序,可以记忆如下:
- 第一步,调用visitCode()方法,调用一次。
- 第二步,调用visitXxxInsn()方法,可以调用多次。对这些方法的调用,就是在构建方法的“方法体”。
- 第三步,调用visitMaxs()方法,调用一次。
- 第四步,调用visitEnd()方法,调用一次。
visitXxxInsn()方法
粗略的来说,MethodVisitor类有15个visitXxxInsn()方法。但严格的来说,有13个visitXxxInsn()方法,再加上visitLabel()和visitTryCatchBlock()这2个方法。
那么,这15个visitXxxInsn()方法,可以用来生成将近200个左右的opcode,也就是用来生成方法体的内容。
public abstract class MethodVisitor {
// (1)
public void visitInsn(int opcode);
// (2)
public void visitIntInsn(int opcode, int operand);
// (3)
public void visitVarInsn(int opcode, int var);
// (4)
public void visitTypeInsn(int opcode, String type);
// (5)
public void visitFieldInsn(int opcode, String owner, String name, String descriptor);
// (6)
public void visitMethodInsn(int opcode, String owner, String name, String descriptor, boolean isInterface);
// (7)
public void visitInvokeDynamicInsn(String name, String descriptor, Handle bootstrapMethodHandle, Object... bootstrapMethodArguments);
// (8)
public void visitJumpInsn(int opcode, Label label);
// (9) 这里并不是严格的visitXxxInsn()方法
public void visitLabel(Label label);
// (10)
public void visitLdcInsn(Object value);
// (11)
public void visitIincInsn(int var, int increment);
// (12)
public void visitTableSwitchInsn(int min, int max, Label dflt, Label... labels);
// (13)
public void visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels);
// (14)
public void visitMultiANewArrayInsn(String descriptor, int numDimensions);
// (15) 这里也并不是严格的visitXxxInsn()方法
public void visitTryCatchBlock(Label start, Label end, Label handler, String type);
}
小结
本文主要是对ASM中MethodVisitor类进行回顾,内容总结如下:
- 第一点,MethodVisitor类的visitXxx()方法要遵循一定的调用顺序。
- 第二点,MethodVisitor类有15个visitXxxInsn()方法,用来生成将近200个左右的opcode。