byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException
通过这个方法,代理可以得到虚拟机载入的类的字节码,并可对其进行修改,完成字节码级的修改。各个参数的含义为:
loader:将被转换的类的类装载器,如果是启动类装载器则此参数可以为空;
className:类名字,不过这是JVM规范定义的全限名字如java/util/List
protectionDomain:保护域,跟安全有关;
classFileBuffer:这个便是被代理类字节码流,正是通过操作这个buffer完成对字节码的修改;
对于函数的返回值,如果返回null,则表示不对类的字节码做任何的修改,否则应该返回修改过的byte[]对象。
除了实现ClassFileTransformer接口外,我们还需要提供一个公共的静态方法:
public static void premain(String agentArgs, Instrumentation inst)
一般会在这个方法中创建一个代理对象,通过Instrumentation对象的addTransformer()方法,将创建的代理对象再传递给虚拟机。
一个简单的演示实例:
agent类实现:
public class HelloWorld implements ClassFileTransformer { @Override public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException { System.out.println("java.lang.instrument, hello world!"); return null; } public static void premain(String args,Instrumentation inst){ inst.addTransformer(new HelloWorld()); } }
监控类:
public class Example { public static void main(String[] args){ System.out.println("main class of proxy!"); } }
将agent类HelloWorld编译成可运行的jar(helloworld.jar),这里注意在manifest文件中添加premain入口,也即其配置为:
- Manifest-Version: 1.0
- Premain-Class: cn.dstrace.instrument.HelloWorld
Manifest-Version: 1.0 Premain-Class: cn.dstrace.instrument.HelloWorld
完成这些步骤以后,通过java -javaagent:helloworld.jar cn.dstrace.instrument.Example运行,则可看到结果:
这里只是简单的演示了java.lang.instrument是怎么作用到被代理类的,后面讲通过字节码操作工具asm来实现一个具体的应用实例,到时候估计就明白了其强大之处,其实在java的各种性能监控工具中都有instrument的身影,如jconsole等