如何编写一个javaAgent jar工具包超详细教程-编程知识

介绍

Java Agent技术

Java Agent技术是JDK提供的用来编写Java工具的技术，使用这种技术生成一种特殊的jar包，这种jar包可以让Java程序
运行其中的代码。
在这里插入图片描述

Java Agent技术的两种模式

Java Agent技术实现了让Java程序执行独立的Java Agent程序中的代码，执行方式有两种：
⚫ 静态加载模式
⚫ 动态加载模式

Java Agent技术的两种模式 - 静态加载模式

静态加载模式可以在程序启动的一开始就执行我们需要执行的代码，适合用APM等性能监测系统从一开始就监控程序
的执行性能。静态加载模式需要在Java Agent的项目中编写一个premain的方法，并打包成jar包。
在这里插入图片描述
接下来使用以下命令启动Java程序，此时Java虚拟机将会加载agent中的代码并执行

premain方法会在主线程中执行：

在这里插入图片描述

Java Agent技术的两种模式 – 动态加载模式

动态加载模式可以随时让java agent代码执行，适用于Arthas等诊断系统。动态加载模式需要在Java Agent的项目中编
写一个agentmain的方法，并打包成jar包
在这里插入图片描述
接下来使用以下代码就可以让java agent代码在指定的java进程中执行了。

agentmain方法会在独立线程中执行：

搭建java agent静态加载模式的环境

步骤：

1、创建maven项目，添加maven-assembly-plugin插件，此插件可以打包出java agent的jar包。
2、编写类和premain方法，premain方法中打印一行信息。
3、编写MANIFEST.MF文件，此文件主要用于描述java agent的配置属性，比如使用哪一个类的
premain方法。
4、使用maven-assembly-plugin进行打包。
5、创建spring boot应用，并静态加载上一步打包完的java agent。

步骤1-4
代码（使用jdk17编辑）:
目录结构:
在这里插入图片描述

maven 项目 pom.xml 文件（关注代码点插件位置）

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>org.example</groupId><artifactId>itheima-agent</artifactId><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
<build><plugins><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></plugins>
</build></project>

AgenMain.java

package com.zss.javaagent;import java.lang.instrument.Instrumentation;public class AgenMain {// premain方法public static void premain(String agentArgs, Instrumentation inst){System.out.println("【remain执行了】");}// premain方法public static void agentmain(String agentArgs, Instrumentation inst){System.out.println("【agentmain执行了】");}
}

MANIFEST.MF

Manifest-Version: 1.0
Premain-Class: com.zss.javaagent.AgenMain
Agent-Class: com.zss.javaagent.AgenMain
Can-Redefine-Classes: true
Can-Retransform-Classes: true
Can-Set-Native-Method-Prefix: true

进行打包在这里插入图片描述
步骤5:
创建springboot项目

JavaAgentTestController.java

package com.example.testdemo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** java -jar -javaagent:D:/jvm/itheima-jvm-java-agent-jar-with-dependencies.jar  .\spring-boot-demo-0.0.1-SNAPSHOT.jar*/
@RestController
@Controller
public class JavaAgentTestController {@GetMapping("/test1")public String test1(String name) {return "test1";}
}

TestdemoApplication.java

package com.example.testdemo;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;import java.nio.ByteBuffer;@SpringBootApplication
public class TestdemoApplication {public static void main(String[] args) {System.out.println("main方法执行了...");SpringApplication.run(TestdemoApplication.class, args);}}

pom文件中我只添加了这个依赖

  <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>

打包操作在这里插入图片描述
启动jar包

java -jar .\testdemo-0.0.1-SNAPSHOT.jar

此时日志只显示main方法执行了…
退出程序 Ctrl+c
如何启动jar包之前启动agent连接到jar包呢（需要再通过java agent命令将jar包引入进来）
右键复制刚才agent jar包的绝对路径
在这里插入图片描述

可以发现已经打印出了agent包里面写的方法了

命令:

java -jar -javaagent:E:\IEDA_DEMO\Study\jvm\javaagent\itheima-agent\target\itheima-agent-1.0-SNAPSHOT-jar-with-dependencies.jar  .\testdemo-0.0.1-SNAPSHOT.jar

上面是操作agent静态加载到jar包当中，下面我们来看看动态加载

搭建java agent动态加载模式的环境

步骤：

1、创建maven项目，添加maven-assembly-plugin插件，此插件可以打包出java agent的jar包。
2、编写类和agentmain方法， agentmain方法中打印一行信息。
3、编写MANIFEST.MF文件，此文件主要用于描述java agent的配置属性，比如使用哪一个类的
agentmain方法。
4、使用maven-assembly-plugin进行打包。
5、编写main方法，动态连接到运行中的java程序。

首先刚才的启动springboot项目
在这里插入图片描述
打开cmd 使用jps 插看当前springboot程序的进程ID记录下来

进程ID为:28712

在这里插入图片描述
新建一个类为:AttachMain.java 将刚才查看的进程ID复制到
下面这段代码里，另一个需要填写的则是agent jar包的绝对路径

package com.zss.javaagent;import com.sun.tools.attach.AgentInitializationException;
import com.sun.tools.attach.AgentLoadException;
import com.sun.tools.attach.AttachNotSupportedException;
import com.sun.tools.attach.VirtualMachine;import java.io.IOException;public class AttachMain {public static void main(String[] args) throws IOException, AttachNotSupportedException, AgentLoadException, AgentInitializationException {//获取进程虚拟机对象  VirtualMachine attach = VirtualMachine.attach("28712");// 执行 java agent 里面的agentmain 方法（所以需要找到jar包的路径）attach.loadAgent("E:\\IEDA_DEMO\\Study\\jvm\\javaagent\\itheima-agent\\target\\itheima-agent-1.0-SNAPSHOT-jar-with-dependencies.jar");}
}