JavaAgent的簡單例子

Posted on by

JavaAgent 是JDK 1.5 以後引入的，也可以叫做Java代理。

JavaAgent 是運行在 main方法之前的攔截器，它內定的方法名叫 premain ，也就是說先執行 premain 方法然後再執行 main 方法。

那麼如何實現一個 JavaAgent 呢？很簡單，隻需要增加 premain 方法即可。

看下面的代碼和代碼中的註釋說明：

package com.shanhy.demo.agent;

import java.lang.instrument.Instrumentation;

/**
 * 我的Java代理
 *
 * @author   單紅宇(365384722)
 * @myblog  http://blog.csdn.net/catoop/
 * @create    2016年3月30日
 */
public class MyAgent {

    /**
     * 該方法在main方法之前運行，與main方法運行在同一個JVM中
     * 並被同一個System ClassLoader裝載
     * 被統一的安全策略(security policy)和上下文(context)管理
     *
     * @param agentOps
     * @param inst
     * @author SHANHY
     * @create  2016年3月30日
     */
    public static void premain(String agentOps, Instrumentation inst) {
        System.out.println("=========premain方法執行========");
        System.out.println(agentOps);
    }

    /**
     * 如果不存在 premain(String agentOps, Instrumentation inst) 
     * 則會執行 premain(String agentOps)
     *
     * @param agentOps
     * @author SHANHY
     * @create  2016年3月30日
     */
    public static void premain(String agentOps) {
        System.out.println("=========premain方法執行2========");
        System.out.println(agentOps);
    }
}

寫完這個類後，我們還需要做一步配置工作。

在 src 目錄下添加 META-INF/MANIFEST.MF 文件，內容按如下定義：

Manifest-Version: 1.0
Premain-Class: com.shanhy.demo.agent.MyAgent
Can-Redefine-Classes: true

要特別註意，一共是四行，第四行是空行，還有就是冒號後面的一個空格，如下截圖：

然後我們打包代碼為 myagent.jar

註意打包的時候選擇我們自己定義的 MANIFEST.MF

接著我們在創建一個帶有main方法的主程序工程，截圖如下：

然後將該主程序打包為 myapp.jar

如何執行 myagent.jar ？我們通過 -javaagent 參數來指定我們的Java代理包，值得一說的是 -javaagent 這個參數的個數是不限的，如果指定瞭多個，則會按指定的先後執行，執行完各個 agent 後，才會執行主程序的 main 方法。

命令如下：

java -javaagent:G:\myagent.jar=Hello1 
-javaagent:G:\myagent.jar=Hello2 
-javaagent:G:\myagent.jar=Hello3 -jar myapp.jar

輸出結果：

G:\>java -javaagent:G:\myagent.jar=Hello1 -javaagent:G:\myagent.jar=Hello2 -javaagent:G:\myagent.jar=Hello3 -jar myapp.jar

=========premain方法執行========

Hello1

=========premain方法執行========

Hello2

=========premain方法執行========

Hello3

特別提醒：如果你把 -javaagent 放在 -jar 後面，則不會生效。也就是說，放在主程序後面的 agent 是無效的。

比如執行：

java -javaagent:G:\myagent.jar=Hello1 
-javaagent:G:\myagent.jar=Hello2 -jar myapp.jar 
-javaagent:G:\myagent.jar=Hello3

隻會有前個生效，第三個是無效的。
輸出結果：

G:\>java -javaagent:G:\myagent.jar=Hello1 -javaagent:G:\myagent.jar=Hello2 -jar myapp.jar -javaagent:G:\myagent.jar=Hello3

=========premain方法執行========

Hello1

=========premain方法執行========

Hello2

命令中的Hello1為我們傳遞給 premain 方法的字符串參數。

至此，我們會使用 javaagent 瞭，但是單單看這樣運行的效果，好像沒有什麼實際意義嘛。

我們可以用 javaagent 做什麼呢？下篇文章我們來介紹如何在項目中應用 javaagent。

最後說一下，還有一種，在main方法執行後再執行代理的方法，因為不常用，而且主程序需要配置 Agent-Class，所以不常用，如果需要自行瞭解下 agentmain(String agentArgs, Instrumentation inst) 方法。

以上就是JavaAgent的簡單例子的詳細內容，更多關於JavaAgent的資料請關註WalkonNet其它相關文章！

推薦閱讀：

    None Found