##特性 在类的字节码载入JVM前会调用ClassFileTransformer的transform方法,从而实现修改原类方法的功能。 ##原理 JVMTI(Java Virtual Machine Tool Interface)是一套本地编程接口集合,它提供了一套『代理』机制,能够支持第三方工具程序以代理的方式链接和访问 JVM,并利用 JVMTI 提供的丰富的编程接口,完成不少跟 JVM 相关的功能。java
java.lang.instrument 包的实现,也就是基于这种机制的:在 Instrumentation 的实现当中,存在一个 JVMTI 的代理程序,经过调用 JVMTI 当中 Java 类相关的函数来完成 Java 类的动态操做。编程
Instrumentation 的最大做用就是类定义的动态改变和操做。在 Java SE 5 及其后续版本当中,开发者能够在一个普通 Java 程序(带有 main 函数的 Java 类)运行时,经过 – javaagent 参数指定一个特定的 jar 文件(包含 Instrumentation 代理)来启动 Instrumentation 的代理程序。函数
##要素 ###Premain-Class 打成jar包,在jar包里面的 META-INF/MAINIFEST.MF 必须包含 Premain-Class这个属性。 若是 JVM 启动时指定了代理,那么此属性是必需的,即包含 premain 方法的类。若是该属性不存在,那么 JVM 将停止。 ###Agent-Class 若是实现支持 VM 启动以后某一时刻启动代理的机制,那么此属性指定代理类。 即包含 agentmain 方法的类。 ###Boot-Class-Path 设置引导类加载器搜索的路径列表。路径表示目录或库(在许多平台上一般做为 JAR 或 zip 库被引用)。 ###Can-Redefine-Classes 布尔值(true 或 false,与大小写无关)。是否能重定义此代理所需的类。true 之外的值均被视为 false。此属性是可选的,默认值为 false。 ###Can-Retransform-Classes 布尔值(true 或 false,与大小写无关)。是否能重转换此代理所需的类。true 之外的值均被视为 false。此属性是可选的,默认值为 false。 ###Can-Set-Native-Method-Prefix 布尔值(true 或 false,与大小写无关)。是否能设置此代理所需的本机方法前缀。true 之外的值均被视为 false。此属性是可选的,默认值为 false。 ##实例工具
import java.lang.instrument.Instrumentation; public class MyAgent { public static void premain(String agentOps, Instrumentation inst){ System.out.println(agentOps); } }
运行.net
java -javaagent:myagent.jar=youragrs -jar demo.jar
##docs代理