Byteman 使用指南（十一）

使用 Java

如果通过 Java 命令行或 Ant 使用 Byteman，需先下载并安装 Byteman。最新的 Byteman 版本可作为 zip 文件从 Byteman 项目下载页面获取。

下载二进制发行版或完整发行版后，将其安装到希望运行 Byteman 的机器的可访问目录中。本指南假定环境变量 BYTEMAN_HOME 指向解压后的二进制发行版目录。

• 二进制发行版：包含所有二进制文件（类文件 JARs 和命令脚本）、程序员指南副本、示例脚本以及相关帮助器 JAR。

• 完整发行版：在二进制发行版的基础上增加源代码和 javadoc JARs。

使用 Ant

若通过 Ant 使用 Byteman，需要 BMUnit 软件包以集成 Byteman 与 JUnit 或 TestNG。有关如何在 Ant 构建脚本中配置以引用 Byteman 下载中的必要 JAR 的信息。更复杂的使用示例可参见 Byteman 故障注入教程。

注意：从 Byteman 1.1 开始，代理仅支持在 JDK 6 或 7 上运行。旧版本支持 JDK 5。

使用 Maven

若通过 Maven 使用 Byteman，特别是结合 BMUnit 软件包用于 JUnit 和 TestNG 的集成，只需声明对 Byteman JAR 的依赖即可。Maven 将自动从中央仓库下载所需 JAR。

在 pom.xml 中添加所需依赖的详细信息。更复杂的使用场景可参见 Byteman 故障注入教程。此外，Byteman 提供了一个 Maven 插件，可在测试周期中解析和类型检查测试规则脚本。

获取源代码构建树

若想了解 Byteman 的内部工作原理，或为项目贡献代码，可从主 Git 仓库获取最新源代码。源代码树采用 Maven 项目结构。

从源代码构建 Byteman

在源代码树顶级目录下执行以下命令可构建 Byteman：

mvn package

此命令会在每个子模块的 target 目录（如 agent/target、submit/target）中生成二进制、源代码和 javadoc JAR，并在 download/target 目录下生成二进制和完整发行版的 zip 文件。

• Ant/Java 命令行用户：将 zip 文件解压到本地 BYTEMAN_HOME 目录。

• Maven 用户：需在本地 Maven 仓库中安装 Byteman JAR，执行：

mvn install

在执行此命令前，应修改根 pom.xml 中的项目版本及子模块的父版本，以避免覆盖中央仓库中的官方版本。

使用 Byteman 运行应用程序

Byteman 教程提供了从简单示例到复杂测试用例的详细说明。建议新手首先参考以下教程：

• Byteman 命令行教程：介绍通过命令行运行 Byteman 的基础操作。

• Byteman BMUnit 教程：演示如何通过 Ant 或 Maven 将 Byteman 集成到 JUnit 或 TestNG 测试中。

• Byteman 故障注入教程：展示了使用 Byteman 进行故障注入测试的高级功能。

配置 Java 代理

通过 Java 命令行使用 Byteman 只需在 JVM 启动时添加一个参数，指向 Byteman 代理及规则脚本文件：

-javaagent:agentlib=options

参数说明

• agentlib：Byteman JAR 的路径。JAR 包含元数据文件，允许 JVM 识别代理入口点。

• options：逗号分隔的选项列表：

注意：若规则目标类由引导类加载器加载，需通过 boot:${BYTEMAN_HOME}/lib/byteman.jar 将 Byteman JAR 添加到引导类路径中。bmjava 脚本会自动处理此需求。

模块支持

Byteman 提供 modules:classname 选项用于模块化运行时中管理类解析。可配置插件类如 org.jboss.byteman.modules.jbossmodules.JBossModulesSystem。JBoss Modules 插件随 Byteman zip 文件一并提供。

动态安装：使用 bminstall -m 命令可自动配置模块插件。插件 JAR 路径为 $BYTEMAN_HOME/contrib/jboss-modules-system。