揭秘Java Agent技术:解锁Java工具开发的新境界

简介: 作为JDK提供的关键机制,Java Agent技术不仅为Java工具的开发者提供了一个强大的框架,还为性能监控、故障诊断和动态代码修改等领域带来了革命性的变革。本文旨在全面解析Java Agent技术的应用场景以及实现方式,特别是静态加载模式和动态加载模式这两种关键模式。

一、Java Agent技术

Java Agent技术是JDK提供的关键机制,专门用于编写高级Java工具。通过这项技术,开发者能够创建特殊的JAR包,这些JAR包能够在Java程序运行时执行其中的代码。Java Agent技术赋予了Java程序执行独立Java Agent程序中代码的能力,这种执行方式分为静态加载模式和动态加载模式两种。

1.静态加载模式

静态加载模式允许在Java程序启动的初始阶段就执行指定的代码,因此特别适用于APM(应用性能管理)等需要从一开始就监控程序执行性能的场景。为实现静态加载,开发者需要在Java Agent项目中编写一个premain方法,并将其打包成JAR包。

public static void premain(string agentArgs, Instrumentation inst){
}

image.gif

之后,通过以下命令启动Java程序,Java虚拟机将自动加载并执行agent中的代码:

java -jar -javaagent:./agent.jar test.jar

image.gif

-javaagent: 告诉JVM在启动应用程序之前加载并应用这个Agent
./agent.jar Java Agent JAR文件的路径
test.jar 要运行的Java应用程序的JAR文件

premain方法将在主线程中执行。

image.gif

2.动态加载模式

与静态加载模式不同,动态加载模式允许在任意时刻执行Java Agent代码,因此特别适用于Arthas等诊断系统。实现动态加载,开发者需要编写一个agentmain方法,并将其打包成JAR包。

public static void agentmain(String agentArgs, Instrumentation inst){
}

image.gif

要执行Java Agent代码,开发者可以使用以下代码片段动态连接到指定进程ID的Java程序:

// 动态连接到指定进程ID的java程序
VirtualMachine vm= VirtualMachine.attach("进程ID");
// 加载iava agent
vm.loadAgent("./agent.jar");

image.gif

与premain方法不同,agentmain方法将在独立线程中执行。这种灵活性使得动态加载模式在需要动态修改或监控运行中的Java应用程序时特别有用。

image.gif

二、案例

1.搭建Java Agent静态加载模式的案例

步骤一:Maven项目构建与插件集成

首先,创建一个新的Maven项目,在项目的pom.xml文件中,添加maven-assembly-plugin插件的配置。这个插件的主要作用是将项目依赖和编译后的类文件打包成一个单独的JAR文件,该文件将作为Java Agent的部署包。

<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                   <!-- 将所有依赖打入同一个jar包中 -->
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <!--指定java agent相关配置文件-->
                    <archive>
                        <manifestFile>src/main/resources/MANIFEST.MF</manifestFile>
                    </archive>
                </configuration>
            </plugin>
image.gif

步骤二:编写Java Agent核心代码

在项目的源代码目录下,编写一个包含premain方法的类。premain方法是Java Agent的生命周期入口,它会在Java应用启动之前执行。在这个方法中,可以编写自定义的逻辑,例如打印一行信息。

public class AgentMain {
    // premain方法
    public static void premain(String agentArgs, Instrumentation inst){
        System.out.println("premain方法");
    }
}
image.gif

步骤三:定义Java Agent的清单文件

创建一个名为MANIFEST.MF的清单文件,并放置在项目的src/main/resources/META-INF目录下。这个文件描述了Java Agent的一些配置属性,比如使用哪个类的premain方法。

Manifest-Version: 1.0
Premain-Class: com.rye.javaagent.AgentMain
Can-Redefine-Classes: true
Can-Retransform-Classes: true
Can-Set-Native-Method-Prefix: true
image.gif
Manifest-Version: 1.0 指定了清单文件的版本,通常为1.0,它用于标识清单文件遵循的规范版本。
Premain-Class: com.rye.javaagent.AgentMain Premain-Class属性指定了Java Agent的主要入口点(包含premain方法的类)。当Java应用程序启动并加载该Agent时,premain方法会被调用。
Can-Redefine-Classes: true 这个属性允许Java Agent在运行时重新定义已加载的类。如果设置为true,Agent可以在不卸载和重新加载整个类的情况下修改类的字节码。这对于实现某些高级功能(如热修复、动态修改代码)非常有用。
Can-Retransform-Classes: true 这个属性允许Java Agent在运行时重新转换已加载的类。与Can-Redefine-Classes不同,Retransform要求类的原始字节码仍然可用,并且重新转换的字节码必须与原始字节码在结构上是兼容的(即具有相同的方法签名和字段)。这允许Agent在保持类结构一致性的情况下修改类的行为。
Can-Set-Native-Method-Prefix: true 这个属性允许Java Agent设置原生方法(native methods)的前缀。如果设置为true,Agent可以为加载的类中的原生方法名添加指定的前缀。这可以用于拦截或修改对原生方法的调用。然而,请注意,这个特性在某些Java版本和平台上可能不可用或受到限制。

步骤四:使用Maven Assembly插件进行打包

在命令行或IDE中使用maven-assembly-plugin插件进行打包。插件会将项目的所有依赖和编译后的类文件打包成一个JAR文件,该文件将作为Java Agent的部署包。

image.gif

步骤五:集成Java Agent到Spring Boot应用中

创建一个新的Spring Boot项目或使用现有的Spring Boot应用。在Spring Boot应用的启动脚本或配置文件中,配置Java Agent的静态加载。这需要在JVM启动参数中添加-javaagent选项,并指定Java Agent的JAR文件路径。

java -jar -javaagent:./agent.jar test.jar
image.gif
-javaagent: 告诉JVM在启动应用程序之前加载并应用这个Agent
./agent.jar Java Agent JAR文件的路径
test.jar 要运行的Java应用程序的JAR文件

2.搭建Java Agent动态加载模式的案例

步骤一:创建Maven项目并配置打包插件

首先,创建一个新的Maven项目,在项目的pom.xml文件中,添加maven-assembly-plugin插件的配置。这个插件的主要作用是将项目依赖和编译后的类文件打包成一个单独的JAR文件,该文件将作为Java Agent的部署包。

<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                   <!-- 将所有依赖打入同一个jar包中 -->
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <!--指定java agent相关配置文件-->
                    <archive>
                        <manifestFile>src/main/resources/MANIFEST.MF</manifestFile>
                    </archive>
                </configuration>
            </plugin>
image.gif

步骤二:编写Java Agent的核心代码

在项目中创建一个新的Java类,用于实现Java Agent的逻辑。在该类中编写agentmain方法。与premain方法不同,agentmain方法支持在Java应用程序运行时动态加载Agent。在这个方法中,可以编写自定义的逻辑,例如打印一行日志信息,以验证Agent已成功加载。

public class AgentMain {
    // agentmain方法
    public static void agentmain(String agentArgs, Instrumentation inst){
        System.out.println("agentmain方法");
    }
}
image.gif

步骤三:配置Java Agent的清单文件

在MANIFEST.MF文件中,指定使用哪个类的agentmain方法作为Java Agent的入口点。这告诉JVM在动态加载Agent时应该调用哪个方法。

Manifest-Version: 1.0
Agent-Class: com.rye.javaagent.AgentMain
Can-Redefine-Classes: true
Can-Retransform-Classes: true
Can-Set-Native-Method-Prefix: true
image.gif

步骤四:构建和打包Java Agent

在命令行或IDE中使用maven-assembly-plugin插件进行打包。插件会将项目的所有依赖和编译后的类文件打包成一个JAR文件,该文件将作为Java Agent的部署包。

image.gif

步骤五:编写Java应用程序以动态加载Java Agent

创建一个新的Java类或在现有的Java项目中添加一个类,用于编写动态加载Java Agent的逻辑。在该类中编写main方法,并使用Java的VirtualMachine类来连接到正在运行的Java应用程序。通过调用VirtualMachine.loadAgent方法,可以动态地将打包好的Java Agent JAR文件加载到目标应用程序中。在加载Agent之前,确保目标Java应用程序已经启动并且处于可连接状态。这涉及到设置适当的JVM参数以启用远程调试或JMX(Java Management Extensions)连接。一旦Agent成功加载,它将开始执行在agentmain方法中定义的逻辑,从而可以在不重启目标应用程序的情况下修改或监视其行为。

public class AttachMain {
    public static void main(String[] args) throws IOException, AttachNotSupportedException, AgentLoadException, AgentInitializationException {
        // 获取进程虚拟机对象
        VirtualMachine vm=VirtualMachine.attach("进程ID");
        // 执行java agent里边的agentmain方法
        vm. loadAgent("./agent.jar");
    }
}
image.gif

总结

本文探讨了Java Agent技术的核心原理和应用价值,展示了它在Java工具开发中的关键作用。通过静态加载和动态加载两种模式,Java Agent能够灵活地在Java程序的不同阶段执行自定义代码,为性能监控、故障诊断和动态代码修改提供了有力支持。希望对大家有所帮助。

相关文章
|
13天前
|
安全 Java Unix
Java语言中的日期与时间处理技术
Java语言中的日期与时间处理技术
|
1天前
|
监控 数据可视化 Java
【JAVA】分布式链路追踪技术概论
【JAVA】分布式链路追踪技术概论
12 2
|
1天前
|
Java
java中强大的时间处理工具:Calendar类(日历类)
`Calendar`类是Java中用来处理日期和时间的类,提供了许多属性来获取日期和时间的不同部分,如年、月、日、小时等。`Calendar`的常用属性包括`YEAR`(年)、`MONTH`(月)、`DATE`/`DAY_OF_MONTH`(日)、`DAY_OF_YEAR`(一年中的第几天)、`DAY_OF_WEEK_IN_MONTH`(一月中第几个星期)、`DAY_OF_WEEK`/`WEEK_OF_MONTH`(星期)等。
4 0
|
2天前
|
Cloud Native Java Devops
【Quarkus 技术系列】「云原生架构体系」在云原生时代下的 Java“拯救者”是 Quarkus,那云原生是什么呢?
【Quarkus 技术系列】「云原生架构体系」在云原生时代下的 Java“拯救者”是 Quarkus,那云原生是什么呢?
14 3
|
6天前
|
安全 Java 开发者
Java并发编程的艺术:解锁多线程同步的奥秘
本文将深入探讨Java并发编程的核心概念,揭示多线程环境下同步机制的工作原理与实践技巧。我们将从基础的synchronized关键字讲起,逐步过渡到高级的Lock接口和并发工具类,最后通过实例分析来加深理解。文章不仅旨在为初学者提供一个清晰的并发编程入门指南,同时也希望能够帮助有一定经验的开发者巩固和提升他们的并发处理能力。
|
7天前
|
开发框架 前端开发 JavaScript
JSP技术已死 ? (Java Server Page technology will die) ?
JSP技术已死 ? (Java Server Page technology will die) ?
10 0
|
8天前
|
Java 知识图谱
Java开发技术知识图谱
Java开发技术知识图谱
12 0
|
12天前
|
存储 机器学习/深度学习 人工智能
Java线性表技术详解与实现
Java线性表技术详解与实现
20 1
|
13天前
|
安全 算法 Java
Java中的并发编程技术:解锁高效多线程应用的秘密
Java作为一种广泛应用的编程语言,其并发编程技术一直备受关注。本文将深入探讨Java中的并发编程,从基本概念到高级技巧,帮助读者更好地理解并发编程的本质,并学会如何在多线程环境中构建高效可靠的应用程序。
|
13天前
|
设计模式 前端开发 Java
Java与HTML的深度融合:技术解析与应用实践
Java与HTML的深度融合:技术解析与应用实践
391 1