Java Agent 简介

一、写在前面

java agent 这个技术出现在 jdk1.5 之后，对于大多数人来说都比较陌生，但是多多少少又接触过，实际上，我们平时用的很多工具，都是基于 java agent 实现的，例如常见的热部署 jrebel，各种线上诊断工具（btrace, greys），还有阿里开源的 arthas。

其实 java agent 一点都不神秘，也是一个 jar 包，只是启动方式和普通 jar 包有所不同，对于普通的jar包，通过指定类的 main 函数进行启动，但是 java agent 并不能单独启动，必须依附在一个 java 应用程序运行。

我们可以使用 agent 技术构建一个独立于应用程序的代理程序，用来协助监测、运行甚至替换其他 jvm 上的程序，使用它可以实现虚拟机级别的 aop 功能。

二、动手写一个 java agent

首先，我们先来写一段简单的 agent 程序：

public class agenttest {
    /**
     * 以 vm 参数的方式载入，在 java 程序的 main 方法执行之前执行
     *
     * @param agentargs
     * @param inst      agent技术主要使用的 api，我们可以使用它来改变和重新定义类的行为
     */
    public static void premain(string agentargs, instrumentation inst) {
        system.out.println("premain start");

        system.out.println(agentargs);
    }

    /**
     * 以 attach 的方式载入，在 java 程序启动后执行
     */
    public static void agentmain(string agentargs, instrumentation inst) {
        system.out.println("agentmain start");

        system.out.println(agentargs);
    }
}

因为 java agent 的特殊性，需要一些特殊的配置，例如指定 agent 的启动类等。这样才能在加载 java agent 之后，找到并运行对应的 agentmain 或者 premain 方法。配置方式主要有两种，一种是利用 maven-assembly-plugin 插件（推荐），一种是 manifest.mf 文件。

2.1 maven-assembly-plugin 插件

          <plugin>
                <groupid>org.apache.maven.plugins</groupid>
                <artifactid>maven-assembly-plugin</artifactid>
                <configuration>
                    <descriptorrefs>
                        <descriptorref>jar-with-dependencies</descriptorref>
                    </descriptorrefs>
                    <archive>
                        <manifestentries>
                            <premain-class>org.agent.agenttest</premain-class>
                            <agent-class>org.agent.agenttest</agent-class>
                            <can-redefine-classes>true</can-redefine-classes>
                            <can-retransform-classes>true</can-retransform-classes>
                        </manifestentries>
                    </archive>
                </configuration>
            </plugin>

2.2 manifest.mf 文件

在 meta-inf 目录下创建 manifest.mf 文件：

manifest-version: 1.0
agent-class: org.agent.agenttest
premain-class: org.agent.agenttest
can-redefine-classes: true
can-retransform-classes: true

值得一提的是，即使新建了 manifest.mf 文件，仍然需要配置 maven-assembly-plugin 信息，否则 manifest.mf 信息会被 maven 生成的信息覆盖掉。

            <plugin>
                <groupid>org.apache.maven.plugins</groupid>
                <artifactid>maven-assembly-plugin</artifactid>
                <configuration>
                    <descriptorrefs>
                        <descriptorref>jar-with-dependencies</descriptorref>
                    </descriptorrefs>
                    <archive>
                        <manifestfile>
                            src/main/resources/meta-inf/manifest.mf
                        </manifestfile>
                    </archive>
                </configuration>
            </plugin>

配置完上面的内容，运行 mvn assembly:single 打包属于 java agent 的 jar 包。

三、运行你的 agent 程序

java agent 程序写好了，怎么运行它呢？上面看到 agent 程序分为两种，一种是 premain 函数，在主程序运行之前执行；一种是 agentmain 函数，在主程序运行之后执行。java 加载这两种 agent 程序也有区别：

3.1 主程序运行前加载

通过 jvm 参数 -javaagent:**.jar[=test] 启动，其中 test 为传入 premain 的 agentargs 的参数，程序启动的时候，会优先加载 java agent，并执行其 premain 方法，这个时候，其实大部分的类都还没有被加载，这个时候可以实现对新加载的类进行字节码修改，但是如果 premain 方法执行失败或抛出异常，那么 jvm 会被中止，这是很致命的问题。

3.2 主程序运行后加载

程序启动之后，通过某种特定的手段加载 java agent，这个特定的手段就是 virtualmachine 的 attach api，这个 api 其实是 jvm 进程之间的的沟通桥梁，底层通过socket 进行通信，jvm a 可以发送一些指令给jvm b，b 收到指令之后，可以执行对应的逻辑，比如在命令行中经常使用的 jstack、jps 等，很多都是基于这种机制实现的。

virtualmachine 的实现位于 tools.jar 中。

        <dependency>
            <groupid>com.sun</groupid>
            <artifactid>tools</artifactid>
            <version>1.8</version>
            <scope>system</scope>
            <systempath>${java.home}/../lib/tools.jar</systempath>
        </dependency>

因为是进程间通信，所以使用 attach api 的也是一个独立的java进程，下面是一个简单的实现：

    public static void main(string[] args) throws ioexception, attachnotsupportedexception, agentloadexception, agentinitializationexception {
        virtualmachine virtualmachine = null;
        try {
            // 1100 是进程号
            virtualmachine = virtualmachine.attach("1100");
            // 第一个参数是 agent jar包路径，第二个参数为传入 agentmain 的 args 参数
            virtualmachine.loadagent("d:\\concurrency-0.0.1-snapshot-jar-with-dependencies.jar", "test");
        } finally {
            if (virtualmachine != null) {
                virtualmachine.detach();
            }
        }

    }

推荐阅读：

基于java instrument的agent实现