Java中Agent的使用详解
Java Agent概述
Java Agent是一种特殊类型的软件组件，它允许在Java虚拟机（JVM）运行时修改应用程序的字节码。这种技术通常用于性能监控、日志记录、系统调试等。Java Agent主要分为两类：
1. 启动时加载的Agent（Pre-Main Agent）
这种类型的Agent在应用程序的主方法（main）执行之前加载。它们通常用于在应用程序启动时进行一些预处理，例如初始化日志框架、植入一些监控代码等。
如何实现：
- 在Agent代码中，你需要实现一个带有特定签名的
premain方法。这个方法是由JVM在启动时自动调用的。 premain方法的签名必须是：public static void premain(String agentArgs, Instrumentation inst)。agentArgs是传递给Agent的任何参数。inst是一个java.lang.instrument.Instrumentation实例，它提供了操作字节码的接口。
代码示例：
import java.lang.instrument.Instrumentation;
public class MyAgent {
public static void premain(String agentArgs, Instrumentation inst) {
System.out.println("Executing premain.........");
// 这里可以进行字节码操纵或其他初始化任务
}
}
如何使用：
- 将上述Agent编译成JAR文件，并在JAR的
MANIFEST.MF文件中指定Premain-Class属性。 - 使用
-javaagent标志启动你的Java应用程序，指定Agent JAR文件。
例如，在MANIFEST.MF中：
Premain-Class: MyAgent
启动Java应用时的命令行：
java -javaagent:path/to/agent.jar -jar myapp.jar
2. 运行时加载的Agent（Agent-On-Load）
这种Agent可以在JVM运行时动态加载和附加，通常用于对正在运行的应用程序进行监控和修改。
如何实现：
- 在Agent代码中，你需要实现一个带有特定签名的
agentmain方法。这个方法在Agent被动态加载到JVM时由JVM调用。 agentmain方法的签名必须是：public static void agentmain(String agentArgs, Instrumentation inst)。
代码示例：
import java.lang.instrument.Instrumentation;
public class MyRuntimeAgent {
public static void agentmain(String agentArgs, Instrumentation inst) {
System.out.println("Executing agentmain.........");
// 这里可以进行字节码操纵或其他任务
}
}
如何使用：
- 编译Agent代码并打包成JAR文件，指定
Agent-Class属性在MANIFEST.MF文件。 - 使用特定的工具（如
attach API）在运行时将Agent加载到目标JVM。
在MANIFEST.MF中：
Agent-Class: MyRuntimeAgent
动态加载Agent（使用attach API的示例）：
import com.sun.tools.attach.VirtualMachine;
public class AttachExample {
public static void main(String[] args) throws Exception {
VirtualMachine vm = VirtualMachine.attach("targetJvmPid");
vm.loadAgent("path/to/agent.jar", "optionalAgentArgs");
vm.detach();
}
}
在上述代码中，targetJvmPid是你想要附加的JVM的进程ID。
path/to/agent.jar : 这是Java Agent的JAR文件的路径。在实际使用中，你需要将其替换为实际的Agent JAR文件的路径。例如，如果你的Agent JAR文件名为myagent.jar并且位于当前目录下，那么这部分应该替换为myagent.jar。
optionalAgentArgs:这是传递给Agent的可选参数。这个字符串将作为参数传递给Agent的agentmain方法。如果你的Agent不需要任何参数，这部分可以为空字符串或者完全省略。
这些示例提供了如何实现和使用这两种类型的Java Agent的基本方法。实际应用中，你可能会根据需求在Agent中进行更复杂的操作，例如使用ASM或Javassist库进行字节码操作。
使用ASM进行字节码操作
在一个Java Agent中使用ASM进行字节码操作通常涉及以下步骤：
- 实现一个ClassFileTransformer：这个类将用来修改类的字节码。
- 注册这个Transformer到Instrumentation对象：在
premain或agentmain方法中。
代码示例：
import java.lang.instrument.ClassFileTransformer;
import java.lang.instrument.Instrumentation;
import java.security.ProtectionDomain;
public class MyAgent {
public static void premain(String agentArgs, Instrumentation inst) {
inst.addTransformer(new MyClassFileTransformer());
}
static class MyClassFileTransformer implements ClassFileTransformer {
@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) {
// 使用ASM API修改类字节码
// 返回新的字节码数组，或者如果没有修改，则返回null
return null;
}
}
}
在上面的代码中，你需要使用ASM的API来修改classfileBuffer（类的字节码数组）。
使用Javassist进行字节码操作
使用Javassist进行字节码操作通常更加简单，因为它允许以接近Java源代码的形式修改类。
代码示例：
import java.lang.instrument.ClassFileTransformer;
import java.lang.instrument.Instrumentation;
import java.security.ProtectionDomain;
import javassist.ClassPool;
import javassist.CtClass;
import javassist.CtMethod;
public class MyAgent {
public static void premain(String agentArgs, Instrumentation inst) {
inst.addTransformer(new MyClassFileTransformer());
}
static class MyClassFileTransformer implements ClassFileTransformer {
@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) {
if (className.equals("my/target/ClassName")) {
try {
ClassPool cp = ClassPool.getDefault();
CtClass cc = cp.get("my.target.ClassName");
CtMethod m = cc.getDeclaredMethod("myMethod");
m.insertBefore("{ System.out.println(\"Method called\"); }");
byte[] byteCode = cc.toBytecode();
cc.detach();
return byteCode;
} catch (Exception e) {
e.printStackTrace();
}
}
return null;
}
}
}
在上面的示例中，我们修改了名为my.target.ClassName的类，并在其myMethod方法开始前插入了一行打印语句。Javassist使得修改字节码更接近于编写普通的Java代码。
总结
Java Agent提供了一种强大的机制来在运行时修改和增强Java应用程序。ASM和Javassist是两个常用的库，用于实现Java Agent中的字节码操作。ASM提供了更低层次的控制，而Javassist则提供了更简单、更直观的方式来处理字节码。选择使用哪个库取决于具体的需求和对字节码操作的熟悉程度。通过这些工具，可以实现诸如性能监控、日志记录、动态代码修改等高级功能。
到此这篇关于Java中Agent的使用详解的文章就介绍到这了,更多相关Java Agent内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
java组件commons-fileupload文件上传示例
这篇文章主要为大家详细介绍了java组件commons-fileupload实现文件上传,具有一定的参考价值，感兴趣的小伙伴们可以参考一下2016-10-10
本文深入探讨了Java List过滤的多种方法及实战应用小结,涉及了使用Collection接口的removeIf方法移除不满足条件的元素,并分析了流API在并行操作中的优势,感兴趣的朋友跟随小编一起看看吧2025-08-08
Spring中的接口重试机制spring-retry之listeners参数解析
这篇文章主要介绍了Spring中的接口重试机制spring-retry之listeners参数解析,注解@Retryable有一个参数listeners没有说明,那么本篇文章我们详细介绍一个这个参数的用,需要的朋友可以参考下2024-01-01
在 Spring Boot中实现参数自动校验主要依靠 Java Bean Validation API（JSR 380）和 Spring 的集成支持,下面给大家介绍Spring Boot 自动参数校验的实现步骤,感兴趣的朋友一起看看吧2025-06-06
maven 在执行package,install,deploy时使用clean与不使用clean的不同之处
有时候用mvn install后，新改的内容不生效，一定要后来使用mvn clean install 才生效，由于之前没有做记录，以及记不清是什么情况下才会出现的问题，于是想看看clean和不clean的区别，感兴趣的朋友跟随小编一起看看吧2021-08-08
图表是一种以简单方式显示信息的图形,JFreeChart允许创建各种交互式和非交互式图表,本文主要介绍了Java绘图库JFreeChart的使用教程,感兴趣的可以了解一下2023-09-09
这篇文章主要介绍了Java线程中的ThreadLocal原理及源码解析,ThreadLocal 的作用是为每个线程保存一份局部变量的引用,实现多线程之间的数据隔离,从而避免了线程不安全情况的发生,需要的朋友可以参考下2023-12-12
这篇文章主要介绍了java中sleep方法和wait方法的五个区别，sleep 方法和 wait 方法都是用来将线程进入休眠状态，但是又有一些区别，下面我们就一起来看看吧2022-05-05
深入理解java内置锁(synchronized)和显式锁(ReentrantLock)
这篇文章主要介绍了Java多线程之内置锁(synchronized)和显式锁(ReentrantLock)的深入理解新的和用法，具有一定参考价值，需要的朋友可以了解下。2017-11-11
spring boot整合mybatis使用c3p0数据源连接mysql
这篇文章主要为大家详细介绍了spring boot整合mybatis使用c3p0数据源连接mysql，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-03-03
最新评论