java instrumentation api 通过 java.lang.instrument.instrumentation 接口提供,核心用法是在 jvm 启动时注册一个实现了 java.lang.instrument.instrumentation 接口的代理类。具体做法是编写一个包含 public static void premain(string agentargs, instrumentation inst) 方法的类,并在其中调用 inst.addtransformer() 注册字节码转换器,或者使用 retransformclasses() 对已加载的类进行重新转换。这样做可以在类被加载到 jvm 之前修改其字节码,从而实现无侵入式的功能增强、监控或调试。

如何通过命令行参数激活 Agent?
直接回答:通过在 JVM 启动命令中添加 -javaagent:jar_path 参数来激活 Agent。需要确保 JAR 包的 META-INF/MANIFEST.MF 文件中正确配置了 Premain-Class 属性,指向包含 premain 方法的类。JVM 会在主类初始化之前加载该 Agent,并调用 premain 方法,此时可以获取 Instrumentation 实例并进行全局注册。

package com.example.agent;
import java.lang.instrument.Instrumentation;
import java.lang.instrument.ClassFileTransformer;
import java.security.ProtectionDomain;
public class MyAgent {
public static void premain(String agentArgs, Instrumentation inst) {
System.out.println("Agent is starting...");
// 注册一个转换器,拦截所有类的加载
inst.addTransformer(new ClassFileTransformer() {
@Override
public byte[] transform(ClassLoader loader,
String className,
Class<?> classBeingRedefined,
ProtectionDomain protectionDomain,
byte[] classfileBuffer) {
if (className != null && className.contains("com.example.target")) {
System.out.println("Transforming class: " + className);
// 这里可以返回修改后的字节码,示例中返回原字节码
return classfileBuffer;
}
return null; // 返回 null 表示不修改
}
});
}
}预期结果:当运行带有 -javaagent:my-agent.jar 参数的 Java 程序时,控制台会打印 Agent is starting...,如果目标类被加载,还会打印 Transforming class: ...。这证明了 Agent 已成功挂载并触发了转换逻辑。
立即学习“Java免费学习笔记(深入)”;
如何动态重定义已加载的类?
直接回答:使用 Instrumentation.retransformClasses() 方法可以对已经加载到 JVM 中的类进行重新转换。这需要先在 premain 阶段通过 inst.addTransformer() 注册转换器,并确保在创建转换器时指定 true 作为第二个参数以允许重定义。之后,在任何时候调用 retransformClasses() 传入具体的类对象,JVM 就会再次触发转换器的 transform 方法,从而更新类的行为。

package com.example.agent;
import java.lang.instrument.Instrumentation;
import java.lang.instrument.ClassFileTransformer;
import java.security.ProtectionDomain;
public class RetransformAgent {
public static void premain(String agentArgs, Instrumentation inst) {
// 注意第二个参数为 true,表示支持 retransform
inst.addTransformer(new ClassFileTransformer() {
@Override
public byte[] transform(ClassLoader loader,
String className,
Class<?> classBeingRedefined,
ProtectionDomain protectionDomain,
byte[] classfileBuffer) {
if (classBeingRedefined != null) {
System.out.println("Retransforming class: " + className);
// 执行实际的字节码修改逻辑
return modifyBytecode(classfileBuffer);
}
return null;
}
}, true);
// 假设我们有一个已加载的类 TargetClass
try {
Class<?> targetClass = Class.forName("com.example.target.TargetClass");
inst.retransformClasses(targetClass);
} catch (Exception e) {
e.printStackTrace();
}
}
private static byte[] modifyBytecode(byte[] original) {
// 模拟字节码修改,例如添加日志
return original;
}
}预期结果:程序启动后,如果 com.example.target.TargetClass 已经被加载,retransformClasses 调用将触发转换器的 transform 方法,并打印 Retransforming class: ...。这表明即使类已经存在于 JVM 中,也能通过 Instrumentation API 动态修改其行为,而无需重启应用。
Transformer 在类加载不同阶段的回调差异是什么?
直接回答:transform 方法在两种情况下被调用:一是类首次加载时(classBeingRedefined 为 null),二是类被重新定义时(classBeingRedefined 不为 null)。在首次加载时,转换器有机会完全替换类的字节码;在重定义时,转换器只能修改现有方法体,不能改变类的结构(如添加或删除字段、方法)。这种差异确保了在运行时安全地更新类行为,同时保持 JVM 的类型系统一致性。


















