BCEL 字節碼工程實戰：從類解析到方法計時包裝器的完整構建指南

案例目標：為 StringBuilder.buildString(int) 添加計時

原方法採用低效字符串拼接（result += char），耗時隨長度平方增長。期望輸出：

Call to method buildString$impl took 20 ms.
Constructed string of length 1000

轉換步驟與關鍵代碼片段

1. 初始化構建工具：

   InstructionFactory ifact = new InstructionFactory(cgen);
   InstructionList ilist = new InstructionList();
   ConstantPoolGen pgen = cgen.getConstantPool();
   String cname = cgen.getClassName();
   MethodGen wrapgen = new MethodGen(method, cname, pgen);
   wrapgen.setInstructionList(ilist);

2. 重命名原方法：複製 MethodGen，名稱加 $impl 後綴，移除原方法，添加新方法。

   MethodGen methgen = new MethodGen(method, cname, pgen);
   cgen.removeMethod(method);
   String iname = methgen.getName() + "$impl";
   methgen.setName(iname);
   cgen.addMethod(methgen.getMethod());

3. 計算參數槽位：靜態方法從 0 開始，非靜態從 1 開始（this 佔槽），累加各參數 Type.getSize()。
4. 保存開始時間：

   ilist.append(ifact.createInvoke("java.lang.System", "currentTimeMillis", Type.LONG, Type.NO_ARGS, Constants.INVOKESTATIC));
   ilist.append(InstructionFactory.createStore(Type.LONG, slot));

5. 調用原方法（$impl）：按靜態/非靜態裝載 this 與參數，INVOKEVIRTUAL/INVOKESTATIC，結果非 void 時存入 slot+2。
6. 打印耗時：獲取 System.out（GETSTATIC），構建字符串常量，調用 PrintStream.print/println，中間插入 currentTimeMillis() - start（LSUB）。
7. 返回結果並最終化：裝載結果（如有），IRETURN/LRETURN/ARETURN，設置 MaxStack/MaxLocals，添加包裝器方法。

完整可運行主程序

public class BCELTiming {
  public static void main(String[] argv) {
    if (argv.length == 2 && argv[0].endsWith(".class")) {
      JavaClass jclas = new ClassParser(argv[0]).parse();
      ClassGen cgen = new ClassGen(jclas);
      Method[] methods = jclas.getMethods();
      // 查找目標方法
      for (Method m : methods) if (m.getName().equals(argv[1])) { addWrapper(cgen, m); break; }
      new FileOutputStream(argv[0]).write(cgen.getJavaClass().getBytes()); // 覆蓋原文件
    }
  }
  // addWrapper() 見上述片段組合
}

驗證結果

[dennis]$ java StringBuilder 1000 2000 4000 8000 16000
Constructed string of length 1000 ...
[dennis]$ java -cp bcel.jar:. BCELTiming StringBuilder.class buildString
[dennis]$ java StringBuilder 1000 2000 4000 8000 16000
Call to method buildString$impl took 20 ms.
Constructed string of length 1000
Call to method buildString$impl took 79 ms.
Constructed string of length 2000
...（耗時呈指數級增長，印證 O(n²) 特性）

BCEL 生態工具

• 驗證器：org.apache.bcel.verifier.VerifierFactory 確保輸出類符合 JVM 規範。
• HTML 反編譯器：java -cp bcel.jar org.apache.bcel.util.Class2HTML StringBuilder.class 生成幀式字節碼視圖，極利於調試。
• BCELifier：輸出構建指定類的 BCEL 源碼（隱藏 API，需閱讀源碼）。

選型建議

• BCEL：Apache 許可證、指令級控制、成熟穩定、廣泛用於 Xalan、AspectJ、JDO 等項目。但 API 繁瑣、速度一般。
• Javassist：源碼級 API、開發效率高、MP/LGPL 雙許可。大多數場景首選。