本文属于Java ASM系列一:Core API当中的一篇。


对于《Java ASM系列一:Core API》有配套的视频讲解,可以点击这里这里进行查看;同时,也可以点击这里查看源码资料。


在刚开始学习ASM的时候,编写ASM代码是不太容易的。或者,有些人原来对ASM很熟悉,但由于长时间不使用ASM,编写ASM代码也会有一些困难。在本文当中,我们介绍一个ASMPrint类,它能帮助我们将.class文件转换为ASM代码,这个功能非常实用。

1. ASMPrint类

下面是ASMPrint类的代码,它是利用org.objectweb.asm.util.TraceClassVisitor类来实现的。在使用的时候,我们注意修改一下classNameparsingOptionsasmCode参数就可以了。

import org.objectweb.asm.Cla***eader;
import org.objectweb.asm.util.ASMifier;
import org.objectweb.asm.util.Printer;
import org.objectweb.asm.util.Textifier;
import org.objectweb.asm.util.TraceClassVisitor;

import java.io.IOException;
import java.io.PrintWriter;

/**
 * 这里的代码是参考自{@link org.objectweb.asm.util.Printer#main}
 */
public class ASMPrint {
    public static void main(String[] args) throws IOException {
        // (1) 设置参数
        String className = "sample.HelloWorld";
        int parsingOptions = Cla***eader.SKIP_FRAMES | Cla***eader.SKIP_DEBUG;
        boolean asmCode = true;

        // (2) 打印结果
        Printer printer = asmCode ? new ASMifier() : new Textifier();
        PrintWriter printWriter = new PrintWriter(System.out, true);
        TraceClassVisitor traceClassVisitor = new TraceClassVisitor(null, printer, printWriter);
        new Cla***eader(className).accept(traceClassVisitor, parsingOptions);
    }
}

在现在阶段,我们可能并不了解这段代码的含义,没有关系的。现在,我们主要是使用这个类,来帮助我们生成ASM代码;等后续内容中,我们会介绍到TraceClassVisitor类,也会讲到ASMPrint类的代码,到时候就明白这段代码的含义了。

2. ASMPrint类使用示例

假如,有如下一个HelloWorld类:

public class HelloWorld {
    public void test() {
        System.out.println("Test Method");
    }
}

对于ASMPrint类来说,其中

  • className值设置为类的全限定名,可以是我们自己写的类,例如sample.HelloWorld,也可以是JDK自带的类,例如java.lang.Comparable
  • asmCode值设置为truefalse。如果是true,可以打印出对应的ASM代码;如果是false,可以打印出方法对应的Instruction。
  • parsingOptions值设置为Cla***eader.SKIP_CODECla***eader.SKIP_DEBUGCla***eader.SKIP_FRAMESCla***eader.EXPAND_FRAMES的组合值,也可以设置为0,可以打印出详细程度不同的信息。

3. 总结

本文主要介绍了ASMPrint类和它的使用示例,内容总结如下:

  • 第一点,ASMPrint类,是通过org.objectweb.asm.util.TraceClassVisitor实现的。
  • 第二点,ASMPrint类的作用,是帮助我们生成ASM代码。当我们想实现某一个功能时,不知道如何下手,可以使用ASMPrint类生成的ASM代码,作为思考的起点。

在当前的阶段,我们可能并不了解ASMPrint类里面代码的含义,但是并不影响我们使用它,让它来帮助我们生成ASM代码。在后续的课程当中,我们会逐步的介绍Core API的内容,到时候就能够去理解代码的含义了。