Apache Commons BCEL 常用 CLI 命令与工具详解
BCEL 无自带 CLI，本文以 Maven 与 JDK 命令链代行：mvn compile、exec:java、dependency:tree，javac、javap、jar tf、sha512sum，全部附实测回显。
Apache Commons BCEL 常用 CLI 命令与工具详解
目标：说清 BCEL 没有 CLI 这一事实，并给出替代性的命令行工具链——用 Maven 命令管理工程与运行示例、用 JDK 自带工具编译运行和反汇编字节码、用校验命令保证 jar 来源可信。已在 Ubuntu 22.04.5 LTS + OpenJDK 17.0.20.1 + Apache Maven 3.6.3 环境实测通过。
一、环境信息
Apache Commons BCEL 是一个纯 API 形态的字节码操作库，官方发行包里只有 jar、javadoc 与源码包，不存在 bcel 可执行命令。日常围绕 BCEL 的命令行操作由两类工具代行：Maven 负责依赖解析、构建与示例运行，JDK 自带的 javac/java/javap/jar 负责编译、运行与反汇编。本章先固定实验环境，再逐条实测命令。
| 项目 | 实测值 |
|---|---|
| 操作系统 | Ubuntu 22.04.5 LTS（x86_64） |
| JDK | OpenJDK 17.0.20.1 |
| Maven | 3.6.3 |
| BCEL | 6.13.0（org.apache.bcel:bcel） |
| 实验工程 | /opt/lab/bcel-demo（demo:bcel-demo:1.0.0） |
cd /opt/lab/bcel-demo && mvn -v
输出节选（实测首尾）：
Apache Maven 3.6.3
Maven home: /usr/share/maven
Java version: 17.0.20.1, vendor: Ubuntu, runtime: /usr/lib/jvm/java-17-openjdk-amd64
OS name: "linux", version: "6.8.0-138-generic", arch: "amd64", family: "unix"
工程 pom 中的依赖声明（BCEL 是 Maven 中央仓库坐标 org.apache.bcel:bcel，不是 commons-bcel:commons-bcel，后者实测 404）：
<dependency>
<groupId>org.apache.bcel</groupId>
<artifactId>bcel</artifactId>
<version>6.13.0</version>
</dependency>
💡 技术拓展：ASM 与 Javassist 同样是纯 API 库、同样不带 CLI，三者都依赖 JDK 工具链做命令行验证，差异在抽象层级与典型场景。本文使用 BCEL，其对象模型最贴近 class 文件原始结构。
| 库 | 抽象层级 | 上手难度 | 典型场景 |
|---|---|---|---|
| BCEL | 常量池/指令完整对象模型 | 中 | class 文件解析、审计、结构级修改与生成 |
| ASM | 事件访问器 + 树 API | 较高 | 高性能字节码织入，框架底层（Spring/CGLIB） |
| Javassist | 源码风格 API | 低 | 运行时插桩、AOP 简单增强 |
二、Maven 命令链
Maven 三条命令覆盖了围绕 BCEL 的日常操作：compile 构建工程、exec:java 免打包直接运行示例、dependency:tree 核对 BCEL 带进来的依赖。
2.1 mvn compile
cd /opt/lab/bcel-demo && mvn compile
输出节选（实测首尾）：
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ bcel-demo ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to /opt/lab/bcel-demo/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.628 s
[INFO] Finished at: 2026-10-13T05:07:03Z
编译产物落在 target/classes，后续所有 java/javap 命令都以它为对象。
2.2 mvn exec:java
exec 插件直接以工程 classpath 运行主类，免去手工拼类路径（BCEL 的两个依赖 commons-io、commons-lang3 会自动带上）：
mvn exec:java -Dexec.mainClass=demo.HelloWorld
实测回显：
Hello, World!
2.3 mvn dependency:tree
mvn dependency:tree
输出节选（实测首尾）：
[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @ bcel-demo ---
[INFO] demo:bcel-demo:jar:1.0.0
[INFO] \- org.apache.bcel:bcel:jar:6.13.0:compile
[INFO] +- org.apache.commons:commons-lang3:jar:3.20.0:compile
[INFO] \- commons-io:commons-io:jar:2.22.0:compile
这棵树回答了"方案 B 手动部署时要带哪几个 jar"：BCEL 主 jar 之外必须补 commons-lang3 3.20.0 与 commons-io 2.22.0。
三、JDK 工具链命令
JDK 自带工具覆盖 BCEL 示例的编译、运行、反汇编与包内容检查四个环节，以下逐条实测。
3.1 javac：编译示例与被解析目标
cd /opt/lab/bcel-demo && javac -d target/classes src/main/java/demo/HelloWorld.java
实测回显（编译成功无输出，验证时间戳）：
ls -l target/classes/demo/HelloWorld.class
实测回显：
-rw-r--r-- 1 root root 477 Oct 13 05:07 target/classes/demo/HelloWorld.class
3.2 java -cp：运行 BCEL 示例
绕过 Maven 直接运行解析示例，类路径需要工程类目录加三个 jar：
java -Dfile.encoding=UTF-8 -cp "target/classes:$HOME/.m2/repository/org/apache/bcel/bcel/6.13.0/bcel-6.13.0.jar:$HOME/.m2/repository/commons-io/commons-io/2.22.0/commons-io-2.22.0.jar:$HOME/.m2/repository/org/apache/commons/commons-lang3/3.20.0/commons-lang3-3.20.0.jar" demo.ParseHello target/classes/demo/HelloWorld.class
实测回显：
完整类名 : demo.HelloWorld
父类 : java.lang.Object
字节码版本 : major=52, minor=0
常量池长度 : 34
访问标志 : 0x21
方法数 : 2
源文件名 : HelloWorld.java
3.3 javap -c：反汇编对照
javap 是检验 BCEL 解析结果是否可信的对照组，-c 输出方法级指令序列：
javap -c target/classes/demo/HelloWorld.class
实测回显：
Compiled from "HelloWorld.java"
public class HelloWorld {
public HelloWorld();
Code:
0: aload_0
1: invokespecial #1 // Method java/lang/Object."<init>":()V
4: return
public static void main(java.lang.String[]);
Code:
0: getstatic #7 // Field java/lang/System.out:Ljava/io/PrintStream;
3: ldc #13 // String Hello, World!
5: invokevirtual #15 // Method java/io/PrintStream.println:(Ljava/lang/String;)V
8: return
}
3.4 javap -v：读取 class 文件版本与常量池
javap -v -cp target/classes demo.HelloWorld
输出节选（实测首尾）：
public class demo.HelloWorld
minor version: 0
major version: 52
flags: (0x0021) ACC_PUBLIC, ACC_SUPER
Constant pool:
#1 = Methodref #2.#3 // java/lang/Object."<init>":()V
#2 = Class #4 // java/lang/Object
major=52 与 BCEL ParseHello 的回显完全一致，两套工具互为印证。注意 javap 需要能定位到类：传文件路径时写 javap -v target/classes/demo/HelloWorld.class，传类名时要配 -cp。
3.5 jar tf：检查 jar 内容
发行包主 jar 的包结构与条目数：
jar tf bcel-6.13.0.jar
输出节选（实测首尾，共 476 个条目）：
META-INF/
META-INF/MANIFEST.MF
org/
org/apache/
org/apache/bcel/
org/apache/bcel/classfile/
jar tf bcel-6.13.0.jar | wc -l
实测回显：
476
3.6 sha512sum：校验发行包完整性
从官方站点下载后的第一件事是校验，BCEL 6.13.0 发行包的实测值：
sha512sum bcel-6.13.0-bin.tar.gz
实测回显：
6ac6ac7ef5a8d463fa85c7f76560dba520ca94f50545b39dbea3bae6f8c4de60f4c7d147af79bc86b2082156fb0059cae4e4783f191658ca967f9283dff56ee3 bcel-6.13.0-bin.tar.gz
与官方 bcel-6.13.0-bin.tar.gz.sha512 文件内容逐字一致，校验通过。
四、组合工作流：编译 → 解析 → 反汇编对照
把上述命令串成一条完整的字节码分析工作流：javac 产出 class 文件，BCEL 程序读取结构信息，javap 反汇编做交叉验证。示例程序 DumpCode.java 用 BCEL 的 InstructionList 遍历并打印指令：
import org.apache.bcel.classfile.ClassParser;
import org.apache.bcel.classfile.JavaClass;
import org.apache.bcel.classfile.Method;
import org.apache.bcel.generic.ConstantPoolGen;
import org.apache.bcel.generic.InstructionHandle;
import org.apache.bcel.generic.InstructionList;
import org.apache.bcel.generic.MethodGen;
import java.io.IOException;
public class DumpCode {
public static void main(String[] args) throws IOException {
JavaClass jc = new ClassParser(args[0]).parse();
ConstantPoolGen cp = new ConstantPoolGen(jc.getConstantPool());
for (Method m : jc.getMethods()) {
if (m.isAbstract() || m.isNative()) {
continue;
}
System.out.println("== 方法 " + m.getName() + m.getSignature());
MethodGen mg = new MethodGen(m, jc.getClassName(), cp);
InstructionList il = mg.getInstructionList();
for (InstructionHandle ih : il) {
System.out.printf("%4d: %s%n", ih.getPosition(), ih.getInstruction());
}
il.dispose();
}
}
}
逐段说明：new ClassParser(args[0]).parse() 读入目标类文件；ConstantPoolGen 包装原常量池供 MethodGen 复用；mg.getInstructionList() 把 Code 属性还原成指令句柄序列；ih.getPosition() 是指令在方法字节码中的偏移，ih.getInstruction() 打印助记符（方括号内是操作码编号与指令长度）；il.dispose() 释放指令句柄间的链表引用。
mvn -q exec:java -Dexec.mainClass=demo.DumpCode -Dexec.args="target/classes/demo/HelloWorld.class"
输出节选（实测首尾）：
== 方法 <init>()V
0: aload_0[42](1)
1: invokespecial[183](3) 1
4: return[177](1)
== 方法 main([Ljava/lang/String;)V
0: getstatic[178](3) 7
3: ldc[18](2) 13
5: invokevirtual[182](3) 15
8: return[177](1)
与 3.3 节 javap -c 的输出逐指令对照：aload_0/invokespecial/return 与 getstatic/ldc/invokevirtual/return 完全一致，偏移也一一对应（0、1、4 与 0、3、5、8），BCEL 的解析结果可信。
最后一条实用命令：解析生成的 class 之前，先用 ls 加 javap 快速核对落盘位置与字节码版本：
ls -l /opt/lab/bcel-demo/GenHello.class
实测回显：
-rw-r--r-- 1 root root 514 Oct 13 05:05 /opt/lab/bcel-demo/GenHello.class
javap -v /opt/lab/bcel-demo/GenHello.class
输出节选（实测首尾）：
minor version: 0
major version: 52
flags: (0x0021) ACC_PUBLIC, ACC_SUPER
major=52 证明生成参数（cg.setMajor(52)）已生效，可以不写解析代码就粗验生成结果。
五、参考链接
- BCEL 官方主页：https://commons.apache.org/proper/commons-bcel/
- BCEL 官方 API 文档：https://commons.apache.org/proper/commons-bcel/apidocs/
- Apache Commons 发行目录：https://downloads.apache.org/commons/bcel/
- Maven Exec 插件主页：https://www.mojohaus.org/exec-maven-plugin/
- javap 工具参考（Oracle JDK 文档）：https://docs.oracle.com/en/java/javase/17/docs/specs/man/javap.html