Java Instrumentation從概念到基本用法詳解
更新時間：2025年09月25日 11:51:40 作者：燎原人生
Java Instrumentation是java.lang.instrument包提供的 API,允許開發(fā)者在類被JVM 加載時對其進行修改,或者在運行時重新定義類的字節(jié)碼,本文給大家介紹Java Instrumentation從概念到基本用法詳解,感興趣的朋友一起看看吧
一、什么是 Java Instrumentation
Java Instrumentation 是 java.lang.instrument 包提供的 API，允許開發(fā)者在類被 JVM 加載時對其進行修改，或者在運行時重新定義類的字節(jié)碼。
主要用途
- 性能監(jiān)控與分析（如：JProfiler、YourKit）
- 代碼覆蓋率工具（如：JaCoCo、Cobertura）
- 動態(tài)代理、AOP
- 安全檢查、沙箱實現(xiàn)
- 熱代碼替換（HotSwap）
二、核心概念
1. Java Agent
Instrumentation 的入口是 Java Agent，它是一種特殊的 jar 包，啟動 JVM 時通過 -javaagent 參數(shù)加載。
Agent Jar 需要在 MANIFEST.MF 里指定入口類：
Premain-Class: com.example.MyAgent
2. Premain & Agentmain
public static void premain(String agentArgs, Instrumentation inst)- JVM 啟動時執(zhí)行（靜態(tài)加載）
public static void agentmain(String agentArgs, Instrumentation inst)- JVM 運行中動態(tài) attach（動態(tài)加載）
3. Instrumentation 接口
這是核心接口，提供了如下能力：
- 添加 ClassFileTransformer
- 獲取已加載的類
- 重定義類（redefineClasses）
- 檢查是否支持 Retransform（isRetransformClassesSupported）
三、基本用法
1. 編寫 Agent
public class MyAgent {
public static void premain(String agentArgs, Instrumentation inst) {
System.out.println("Agent loaded!");
inst.addTransformer(new MyTransformer());
}
}2. 實現(xiàn) ClassFileTransformer
public class MyTransformer implements ClassFileTransformer {
@Override
public byte[] transform(
ClassLoader loader, String className, Class<?> classBeingRedefined,
ProtectionDomain protectionDomain, byte[] classfileBuffer
) {
// 可以用 ASM/Javassist 修改字節(jié)碼
if (className.equals("com/example/TargetClass")) {
// 返回修改后的字節(jié)碼
}
return null; // 返回 null 表示不修改
}
}3. 啟動 JVM 時加載
java -javaagent:myagent.jar -jar myapp.jar
四、進階應(yīng)用
1. 動態(tài) Attach
JDK 提供了 com.sun.tools.attach.VirtualMachine 實現(xiàn)動態(tài) attach agent 到運行中的 JVM。
VirtualMachine vm = VirtualMachine.attach("pid");
vm.loadAgent("myagent.jar");2. 字節(jié)碼修改
常用工具有 ASM、Javassist、ByteBuddy。例如用 ASM 修改方法字節(jié)碼，實現(xiàn)方法增強、插樁。
3. 熱代碼替換
通過 Instrumentation.redefineClasses 可以在不重啟 JVM 的情況下替換已加載類的實現(xiàn)（有一定限制）。
五、典型案例
1. 性能監(jiān)控
在所有方法入口和出口插入計時代碼，統(tǒng)計每個方法的耗時。
2. 代碼覆蓋率
在每個分支、方法插入標(biāo)記，記錄哪些代碼被執(zhí)行過。
3. 安全防護
在敏感 API 調(diào)用前插入權(quán)限檢查邏輯。
六、注意事項
- 并非所有類都能被重新定義（如 JVM 內(nèi)部類、已被 native 方法鎖定的類）。
- 字節(jié)碼修改需謹(jǐn)慎，容易引發(fā)兼容性和穩(wěn)定性問題。
- 動態(tài) attach 需要目標(biāo) JVM 開啟 attach 功能（通常為同一用戶）。
七、實戰(zhàn)案例
編寫一個Java Instrumentation接口性能監(jiān)控示例
1. 創(chuàng)建 Java Agent
PerformanceMonitorAgent.java
import java.lang.instrument.Instrumentation;
public class PerformanceMonitorAgent {
public static void premain(String agentArgs, Instrumentation inst) {
System.out.println("PerformanceMonitorAgent loaded.");
inst.addTransformer(new PerformanceTransformer());
}
}2. 編寫 Transformer
PerformanceTransformer.java
import java.lang.instrument.ClassFileTransformer;
import java.security.ProtectionDomain;
public class PerformanceTransformer implements ClassFileTransformer {
@Override
public byte[] transform(
ClassLoader loader,
String className,
Class<?> classBeingRedefined,
ProtectionDomain protectionDomain,
byte[] classfileBuffer) {
// 只監(jiān)控特定包下的類（比如com/example/）
if (className != null && className.startsWith("com/example/")) {
// 使用ASM或Javassist修改字節(jié)碼，在方法前后插入耗時統(tǒng)計代碼
try {
return MethodTimer.injectTimer(classfileBuffer);
} catch (Exception e) {
e.printStackTrace();
}
}
return classfileBuffer;
}
}3. 使用 Javassist 修改字節(jié)碼
MethodTimer.java
import javassist.*;
public class MethodTimer {
public static byte[] injectTimer(byte[] classfileBuffer) throws Exception {
ClassPool pool = ClassPool.getDefault();
CtClass ctClass = pool.makeClass(new java.io.ByteArrayInputStream(classfileBuffer));
for (CtMethod method : ctClass.getDeclaredMethods()) {
if (!method.isEmpty() && !method.getName().equals("<init>")) {
method.addLocalVariable("_startTime", CtClass.longType);
method.insertBefore("_startTime = System.nanoTime();");
method.insertAfter(
"System.out.println(\"[Performance] Method " + method.getName() +
" executed in \" + (System.nanoTime() - _startTime) + \" ns.\");"
);
}
}
byte[] byteCode = ctClass.toBytecode();
ctClass.detach();
return byteCode;
}
}4. 目標(biāo)類示例
com/example/Demo.java
package com.example;
public class Demo {
public void test() {
try { Thread.sleep(100); } catch (Exception e) {}
}
public static void main(String[] args) {
new Demo().test();
}
}5. 編譯 & 打包 Agent
javac -cp javassist.jar:. PerformanceMonitorAgent.java PerformanceTransformer.java MethodTimer.java jar cmf MANIFEST.MF perfagent.jar PerformanceMonitorAgent.class PerformanceTransformer.class MethodTimer.class
MANIFEST.MF 內(nèi)容：
Premain-Class: PerformanceMonitorAgent Can-Redefine-Classes: true Can-Retransform-Classes: true
6. 運行目標(biāo)程序并加載 Agent
java -javaagent:perfagent.jar -cp javassist.jar:. com.example.Demo
7. 輸出示例
PerformanceMonitorAgent loaded.
[Performance] Method test executed in 100123456 ns.
說明：
- 這個例子用 Javassist 修改字節(jié)碼，在每個方法前后插入耗時統(tǒng)計代碼。
- 你可以根據(jù)需要修改
PerformanceTransformer，選擇需要監(jiān)控的類和方法。 - 實際生產(chǎn)環(huán)境建議將統(tǒng)計結(jié)果匯總、寫入日志或上報到監(jiān)控系統(tǒng)。
到此這篇關(guān)于Java Instrumentation詳解的文章就介紹到這了,更多相關(guān)Java Instrumentation內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
最簡單的spring boot打包docker鏡像的實現(xiàn)
這篇文章主要介紹了最簡單的spring boot打包docker鏡像的實現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10
Java?基于Hutool實現(xiàn)DES加解密示例詳解
這篇文章主要介紹了Java基于Hutool實現(xiàn)DES加解密，本文通過示例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-08-08
spring cloud 之 客戶端負(fù)載均衡Ribbon深入理解
下面小編就為大家?guī)硪黄猻pring cloud 之 客戶端負(fù)載均衡Ribbon深入理解。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-06-06
java中重寫equals()方法的同時要重寫hashcode()方法(詳解)
下面小編就為大家?guī)硪黄猨ava中重寫equals()方法的同時要重寫hashcode()方法(詳解)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-05-05
REST：Representational State Transfer，資源表現(xiàn)層狀態(tài)轉(zhuǎn)換，是目前⽐較主流的⼀種互聯(lián)網(wǎng)軟件架構(gòu)，它結(jié)構(gòu)清晰、標(biāo)準(zhǔn)規(guī)范、易于理解、便于擴展2021-09-09
這篇文章主要為大家詳細(xì)介紹了基于zookeeper實現(xiàn)分布式鎖，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-05-05
本文詳細(xì)介紹了Mybatis映射文件的結(jié)構(gòu)、標(biāo)簽和使用方法,包括mapper元素、標(biāo)簽的主要屬性如id、parameterType、resultType以及動態(tài)SQL和結(jié)果映射的使用,通過映射文件,可以將數(shù)據(jù)庫表與Java對象映射,支持查詢、插入、更新、刪除等操作,提高了SQL語句的靈活性和可重用性2024-09-09
SpringBoot4中api版本控制的實現(xiàn)示例
本文主要介紹了SpringBoot4中api版本控制,通過在請求注解中添加版本號,可以實現(xiàn)API的版本控制,從而避免對現(xiàn)有客戶端造成兼容性問題2026-02-02
本文主要介紹了Spring batch批處理框架的相關(guān)知識。具有很好的參考價值，下面跟著小編一起來看下吧2017-04-04
Spring AI內(nèi)置DeepSeek的詳細(xì)步驟
Spring AI 最新快照版已經(jīng)內(nèi)置 DeepSeek 了,所以以后項目中對接 DeepSeek 就方便多了,但因為快照版會有很多 Bug,所以今天咱們就來看穩(wěn)定版的 Spring AI 如何對接 DeepSeek 滿血版,感興趣的小伙伴跟著小編一起來看看吧2025-02-02