本章节介绍的是 Byteman 预览版本的功能，可能与后续版本有所不同。
当 Byteman 规则被注入方法时，注入的代码需要根据注入上下文中的可用值和类型进行解析。例如，当规则注入到类 String 的方法 charAt 中时，对参数变量 $1 的引用会通过检查方法类型签名确定其为 int 类型。注入的代码从触发方法调用的局部槽位 1 中加载整数值，并将其传递给规则执行引擎。
类似地，对 Thread.currentThread() 的调用会通过识别类名 java.lang.Thread 并定位其方法，确定返回值为 Thread 类型。规则执行引擎根据解析后的方法执行表达式以获得其值。
解析类型名称需要利用类加载器检查目标类是否 “在范围内”。Byteman 使用触发类的类加载器解释 “在范围内” 的含义。例如，在以下规则中，注入到类 org.my.ThreadPool 的代码可以直接引用 org.my.Logger 并调用其静态方法：
RULE call out to logging method
CLASS org.my.ThreadPool
METHOD schedule(Runnable)
BIND runnableKlazz = $1.getClass().getName()
IF TRUE
DO org.my.Logger.log(runnableKlazz, "scheduled: " + System.currentTimeMillis())
由于这两个类都由系统类加载器加载，它们可以被互相引用。然而，在 Java EE 部署中，跨 jar 或部署的引用可能会失效。如果 org.my.ThreadPool 和 org.my.Logger 部署在不同的 war 文件中，它们的类加载器可能无法相互解析引用。在模块系统（如 JBoss Modules 或 OSGi）中，甚至无法解析系统或引导类路径中的类。
IMPORT 解决模块依赖为了解决跨模块引用的问题，Byteman 提供了 IMPORT 声明，允许开发者显式指定需要引用的其他模块中的类。通过 IMPORT 声明，可以确保这些类对规则代码 “在范围内”，从而避免类加载器无法解析类的问题。以下是一个具体示例，展示了如何通过 IMPORT 声明引入 JBoss 模块中的 TransactionManager 类，从而在记录线程调度操作时访问事务信息：
RULE log thread schedule operations with details of current TX
CLASS org.my.ThreadPool
METHOD schedule(Runnable)
IMPORT javax.transaction.api
BIND runnableKlazz = $1.getClass().getName()
IF TRUE
DO traceln(runnableKlazz + " scheduled at " +
System.currentTimeMillis() + " in TX " +
javax.transaction.TransactionManager.getTransaction())
IMPORT 声明：
通过 IMPORT javax.transaction.api 显式引入 JBoss 模块中的事务 API，确保规则代码能够访问 javax.transaction.TransactionManager 类。
规则逻辑：
org.my.ThreadPool 类的 schedule(Runnable) 方法中，规则会记录当前线程调度操作的详细信息。BIND 语句将 Runnable 对象的类名绑定到变量 runnableKlazz。DO 语句中，通过 traceln 输出调度时间、任务类名以及当前事务信息。模块名称格式：
导入的模块名称格式取决于所使用的模块系统。例如，在 JBoss EAP 中，事务 API 模块的名称为 javax.transaction.api。
traceln 输出关键操作的详细信息，便于调试和性能分析。通过 IMPORT 声明，Byteman 显著提升了在模块化环境中的灵活性和实用性，为开发者提供了更强大的工具来应对复杂的应用场景。
可以通过多次使用 IMPORT 声明导入多个模块，也可以在脚本级别定义导入，以适用于所有后续规则。以下示例演示了不同作用域的导入：
# 导入 TX 和 JPA API
IMPORT javax.transaction.api
IMPORT javax.persistence.api
RULE resolve TX and JPA classes
CLASS ...
METHOD ...
AT ENTRY
IMPORT javax.transaction.api
...
ENDRULE
# 清除脚本级导入，使用 Hibernate API
RULE resolve Hibernate classes
CLASS ...
METHOD ...
AT ENTRY
IMPORT
IMPORT org.hibernate
...
ENDRULE
# 清除所有脚本级导入
IMPORT
RULE resolve only trigger class scope
...
ENDRULE
为了使模块导入功能生效，Byteman 需要扩展插件以支持模块系统的类加载器解析。这一功能的关键在于插件能够与特定的模块系统（如 JBoss Modules、OSGi 或 JDK Jigsaw）无缝集成，从而确保 Byteman 能够正确加载和解析模块中的类。
在安装 Byteman 代理时，开发者需要完成插件的配置。目前，Byteman 提供了与 JBoss Modules 模块系统兼容的插件，能够支持基于 JBoss Modules 的应用程序的类加载和规则注入。未来，Byteman 计划扩展对其他模块系统的支持，例如 OSGi 和 JDK Jigsaw，从而覆盖更广泛的应用场景。
通过这种模块化的扩展支持，Byteman 能够在复杂的模块化环境中灵活运行，为开发者提供更强大的工具来调试、测试和监控基于模块系统的应用程序。这种设计不仅提升了 Byteman 的兼容性，也为未来的功能扩展奠定了坚实的基础。
FunTester 原创精华