FunTester Byteman 使用指南(十二)

FunTester · 2025年02月16日 · 1437 次阅读

使用脚本 bmjava 运行 Byteman

安装目录下的 bin 包含一个名为 bmjava 的脚本,可用于组合 Byteman 代理选项,并将其与 Java 命令行中的其他选项整合。命令行语法如下:

bmjava [-p port] [-h host] [ -l script|-b jar|-s jar|-nb|-nl|-nj ]* [--] javaargs
  • -l script:在程序启动时加载 script 文件中的规则。
  • -b jar:将 jar 文件添加到引导类路径。
  • -s jar:将 jar 文件添加到系统类路径。
  • -p port:指定侦听器的端口(默认值:9091)。
  • -h host:指定侦听器的主机名(默认值:localhost)。
  • -nb:禁止将 Byteman JAR 添加到引导类路径(默认情况下会添加)。
  • -nl:禁止启动代理侦听器(默认情况下会启动)。
  • -nj:禁止注入 java.lang 类(默认情况下允许)。

使用脚本 bmsubmit 动态提交规则

bin 目录下的 bmsubmit 脚本用于与通过 listener:true 启动的 Byteman 代理侦听器通信。支持动态上传规则、卸载规则、查询已注入的规则,以及安装帮助器类的 JAR。

命令行语法如下:

submit [-p port] [-h host] [-l|-u] [script1 . . . scriptN]
submit [-p port] [-h host] [-b|-s] jarfile1 . . .
submit [-p port] [-h host] -c
submit [-p port] [-h host] -y [prop1[=[value1]]. . .]
submit [-p port] [-h host] -v
  • -p port-h host:指定代理侦听器的端口和主机地址(默认值:9091 和 localhost)。
  • -l:上传规则脚本到代理。如果不提供参数,将列出当前应用的转换状态。
  • -u:卸载规则。如果带有脚本文件参数,则卸载与脚本文件中定义规则同名的已加载规则。
  • -b-s:分别将 JAR 文件添加到引导或系统类路径。此模式无撤销功能,安装后无法卸载。
  • -c:列出已安装到引导或系统类路径的帮助器 JAR。
  • -y:列出或动态更新代理的系统属性。未提供参数时,显示所有前缀为 org.jboss.byteman. 的属性值;提供参数时,修改或清除指定属性。

使用脚本 bmcheck 离线检查规则

bmcheck 脚本用于在将规则注入程序前,离线解析和类型检查 Byteman 规则。命令行语法如下:

bmcheck [-cp classpath] [-p package]* script1 [. . . scriptN]
  • -cp:指定类路径,用于定位规则中引用的类。
  • -p:提供包名,用于解析未指定包名的目标类。例如,CLASS myClass 会通过 -p org.myApp 解析为 org.myApp.myClass

从 Java 安装和提交规则

脚本 bminstallbmsubmitbyteman-installbyteman-submit JAR 的封装,支持从任何 Java 程序调用以加载代理或规则。例如:

  • BMUnit:扩展 JUnit 和 TestNG 框架,在测试执行时动态加载和卸载规则。
  • DTest:支持从客户端注入服务器 JVM 中的故障。

Byteman 代理加载和卸载生命周期

Byteman 实现了 JVMTI Java 代理 API,允许在 JVM 中优先加载并执行字节码转换:

  1. 代理加载:通过 -javaagent 启动时,代理代码在 JVM 引导时加载;通过 bminstall 动态安装时,代理代码立即加载。
  2. 规则注入listener 选项启用后,代理侦听器线程持续运行,可动态加载、卸载规则。侦听器线程为守护线程,不会中断 JVM 的运行。
  3. 代理限制:Byteman 代理只能加载一次,且无法卸载。此外,代理类必须通过系统或引导类加载器加载。

环境设置

通过以下环境变量可配置代理行为:

  • org.jboss.byteman.compileToBytecode:启用规则的字节码编译(默认通过解释执行规则)。
  • org.jboss.byteman.dump.generated.classes:转储转换后的类字节码。
  • org.jboss.byteman.dump.generated.classes.directory:设置转储目录。
  • org.jboss.byteman.verbose / org.jboss.byteman.debug:启用调试日志输出。
  • org.jboss.byteman.transform.all:允许规则注入 java.lang 类。
  • org.jboss.byteman.skip.overriding.rules:禁止在覆盖方法中执行规则(提高性能)。
  • org.jboss.byteman.allow.config.updates:允许通过 bmsubmit 动态更新配置。
  • org.jboss.byteman.sysprops.strict:限制系统属性修改,仅允许前缀为 org.jboss.byteman. 的属性。
FunTester 原创精华

【连载】从 Java 开始性能测试

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
暂无回复。
需要 登录 后方可回复, 如果你还没有账号请点击这里 注册