BCEL 位元組碼工程：在方法呼叫點插入計時攔截邏輯

Apache BCEL (Byte Code Engineering Library) 允許運行時修改類別檔。本文示範掃描特定方法呼叫點，在其前後插入計時輸出邏輯，實現無侵入式效能分析。

目標轉換

原始碼

String result = inst.buildString(Integer.parseInt(argv[i]));
System.out.println("Constructed string of length " + result.length());

轉換後

long startTime = ToolUtil.printStart();
String result = inst.buildString(Integer.parseInt(argv[i]));
ToolUtil.printEnd("buildString", startTime);
System.out.println("Constructed string of length " + result.length());

輔助工具類 (預先編譯)

public class ToolUtil {
    public static long printStart() {
        System.out.println("start start start start");
        return System.currentTimeMillis();
    }
    public static void printEnd(String methodName, long start) {
        System.out.println("Call to " + methodName + " took " + (System.currentTimeMillis()-start) + " ms.");
        System.out.println("end end end end end end");
    }
}

BCEL 轉換器核心邏輯

public class BCELTiming {
    private static void modifyWrapper(ClassGen cgen, String targetClass, String targetMethod, String targetSig) {
        InstructionFactory factory = new InstructionFactory(cgen);
        ConstantPoolGen cp = cgen.getConstantPool();
        
        for (Method method : cgen.getMethods()) {
            MethodGen mg = new MethodGen(method, cgen.getClassName(), cp);
            InstructionList il = mg.getInstructionList();
            if (il == null) continue;
            
            InstructionHandle[] handles = il.getInstructionHandles();
            for (InstructionHandle ih : handles) {
                Instruction ins = ih.getInstruction();
                // 尋找 INVOKEVIRTUAL 指令
                if (ins.getOpcode() == Constants.INVOKEVIRTUAL) {
                    INVOKEVIRTUAL invoke = (INVOKEVIRTUAL) ins;
                    ConstantMethodref cmr = (ConstantMethodref) cp.getConstant(invoke.getIndex());
                    ConstantClass cc = (ConstantClass) cp.getConstant(cmr.getClassIndex());
                    String className = cc.getBytes(cp.getConstantPool());
                    ConstantNameAndType cnt = (ConstantNameAndType) cp.getConstant(cmr.getNameAndTypeIndex());
                    String methodName = cnt.getName(cp.getConstantPool());
                    String sig = cnt.getSignature(cp.getConstantPool());
                    
                    // 匹配目標方法
                    if (className.equals(targetClass) && methodName.equals(targetMethod) && sig.equals(targetSig)) {
                        // 1. 移除舊方法，準備重建
                        cgen.removeMethod(mg.getMethod());
                        
                        // 2. 前置插入：呼叫 printStart() 並存入區域變數
                        LocalVariableGen lvg = mg.addLocalVariable("startTime", Type.LONG, null, null);
                        InstructionList before = new InstructionList();
                        before.append(factory.createInvoke("ToolUtil", "printStart", Type.LONG, Type.NO_ARGS, Constants.INVOKESTATIC));
                        before.append(InstructionFactory.createStore(Type.LONG, lvg.getIndex()));
                        il.insert(ih.getPrev().getPrev(), before);  // 插入呼叫指令前
                        
                        // 3. 後置插入：載入區域變數、方法名，呼叫 printEnd()
                        InstructionList after = new InstructionList();
                        after.append(factory.createConstant(methodName));
                        after.append(factory.createLoad(Type.LONG, lvg.getIndex()));
                        after.append(factory.createInvoke("ToolUtil", "printEnd", Type.VOID, new Type[]{Type.STRING, Type.LONG}, Constants.INVOKESTATIC));
                        il.insert(ih.getNext().getNext(), after);   // 插入呼叫指令後
                        
                        // 4. 完成方法重建
                        mg.stripAttributes(false);
                        mg.setMaxStack();
                        mg.setMaxLocals();
                        cgen.addMethod(mg.getMethod());
                        break; // 假設每方法僅一處呼叫點
                    }
                }
            }
        }
    }
    
    public static void main(String[] args) throws Exception {
        JavaClass jc = new ClassParser(args[0]).parse();
        ClassGen cgen = new ClassGen(jc);
        modifyWrapper(cgen, "StringBuilder", "buildString", "(I)Ljava/lang/String;");
        cgen.getJavaClass().dump(args[0]); // 覆蓋原 class 檔
    }
}

關鍵技術點

1. 指令掃描：遍歷 InstructionList 尋找 INVOKEVIRTUAL/INVOKESTATIC/INVOKEINTERFACE
2. 常量池解析：透過 ConstantMethodref → ConstantClass + ConstantNameAndType 還原類名、方法名、簽名
3. 區域變數管理：MethodGen.addLocalVariable() 自動分配 Slot，避免衝突
4. 指令插入位置：ih.getPrev().getPrev() 定位至呼叫指令前的邊界 (視具體指令序列微調)
5. 方法重建：stripAttributes/setMaxStack/setMaxLocals 更新屬性表

優缺點分析

現代替代方案：Java Agent + ASM/ByteBuddy 實現運行時類別重定義，或編譯期註解處理器 (Lombok/MapStruct 模式)。BCEL 適合學習位元組碼結構與輕量級離線轉換。

1. 上一篇文章： Java Swing 實現三狀態聯動 CheckBox Tree (父子節點遞歸選取)
2. 下一篇文章： 使用 BCEL 直接修改方法字節碼：實戰指南

Java 相關知識

Spring 框架核心機制深度解析：IoC、AOP、Bean 生命週期與依賴注入全圖解

Spring 自 2004 年首版釋出以來，憑藉低侵入設計、

精通 Grails：整合遺留資料庫——靈活映射非標準命名慣例

GORM（Grails Object Relational

Spring Boot 集成 MyBatis 註解版完整教程：從建表到 REST API

數據庫準備 CREATE TABLE IF NOT EXI

手把手教你撰寫 Gulp 外掛 (以 through2 / through-gulp 為例)

Gulp 生態豐富，但有時需求獨特，自行開發外掛其實不複雜。