JavaAgent的簡單例子

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其它相關文章!