使用JRebel启动工程时加上VM参数时有一个参数是"-javaagent:D:\jrebel_5.6.0\jrebel.jar"。
javaagent是什么? java -help后看到如下信息:
Java代理不是应用程序中的一部分,instrument支持Java以代理的形式监控或重新定义运行中的服务。
我们可以在不修改程序代码的前提下通过Instrumentation API改变运行中的java程序。
而我们使用的"-javaagent:jarpath[=options] "参数则是一种方式,也就是在应用程序启动前执行代理。
参数值是个jar路径,先让我们试着写一个代理,再将其导出为jar.
鉴于没有什么实际目的,那就以java agent的使用为重点,尽量写得简单一些。
所谓agent的代码实现就是一个带premain()方法的类,但这个方法并不是根据某个抽象,而是硬生生地定义到类里。
premain方法的声明可以是public static void premain(String args, Instrumentation inst)或 public static void premain(String args)。
参数String args对应"-javaagent:jarpath[=options] "中的options。
参数Instrumentation inst则是运行时传入的Instrumentation实例。
package pac.testcase.basic.agent;
import java.lang.instrument.Instrumentation;
public class TestAgent {
public static void premain(String agentArgs, Instrumentation inst){
System.out.println("Alvez Agent:::");
}
}
将TestAgent导出为jar,假设我的导出路径是"D:/myAgent.jar"。
随便写一个main方法,加上参数"-javaagent:D:/myAgent.jar"并运行:
package pac.testcase.basic.agent;
public class TestAgentMain {
public static void main(String[] args) throws InterruptedException {
System.out.println("code in runtime::");
}
}
结果提示:
Error occurred during initialization of VM
agent library failed to init: instrument
Failed to find Premain-Class manifest attribute in D:/myAgent.jar
需要在MANIFEST.MF中在加一条属性,手动指定premain class,比如本例中改为如下:
Manifest-Version: 1.0
Premain-Class: pac.testcase.basic.agent.TestAgent
Can-Redefine-Classes: true
接下来就可以运行了,结果输出:
Alvez Agent:::
code in runtime::
但只是这样没什么意思,我们只能在应用程序运行之前指定premain class,结果还是没有做到运行时进行改变,有没有办法在运行后指定代理程序?
程序运行时发生不曾预料的情况,此时用代理临时解决突发状况才更加有意义,但解决这一问题的并不是premain而是agentmain。
和premain相似的是,方法声明几乎相同,即public static void agentmain(String args, Instrumentation inst)或 public static void agentmain(String args)。
package pac.testcase.basic.agent;
import java.lang.instrument.Instrumentation;
public class TestAgent {
public static void agentmain(String agentArgs, Instrumentation inst){
System.out.println("Alvez Agent:::");
}
}
另外,在MANIFEST指定的属性名也改为Agent-Class,如下:
Manifest-Version: 1.0
Agent-Class: pac.testcase.basic.agent.TestAgent
Can-Redefine-Classes: true
(Ps:即使同时指定了Premain-Class和Agent-Class也不会有问题。)
和Premain不同的是,使用Agentmain时我们需要使用tools.jar中的com.sun.tools.attach.VirtualMachine,将代理jar绑定到指定VM,比如:
VirtualMachine vm = VirtualMachine.attach("");
vm.loadAgent("");
获得相应的VM,并通过loadAgent指定agentmain jar。
两者都用Instrumentation
光看了下该方法的声明,没想太多,弄了个premain方法初始化Instrumentation:
public class ObjectSizeUtils {
private static Instrumentation inst = null;
public static void premain(String agentArgs, Instrumentation inst) {
ObjectSizeUtils.inst = inst;
}
public static long sizeOf(Object o){
if(inst == null) throw new IllegalStateException("not initialized yet");
return inst.getObjectSize(o);
}
}
export jar并在MANIFEST.MF中加上:
Premain-class: pac.testcase.utils.ObjectSizeUtils
Can-Redefine-Classes: false
随便写一个实体类,用来测试:
class Person{
private String name;
private String life;
public String getName() {return name;}
public void setName(String name) {this.name = name;}
public String getLife() {return life;}
public void setLife(String life) {this.life = life;}
}
好了,在运行参数中加上-javaagent,执行看看会输出什么:
@Test
public void testSizeUtils(){
Person person = new Person("Alvez","make me death before you make me old");
logger.info(String.valueOf(sizeOf(person)));
logger.info(String.valueOf(sizeOf(person.getName())));
logger.info(String.valueOf(sizeOf(person.getLife())));
}
static final Logger logger = LoggerFactory.getLogger(ObjectSizeUtils.class);
结果很奇怪...
为什么person的属性比person还大? 等等,name和life的大小好像也有问题....
回去翻教科书发现事情并不是我希望的那样,我需要把对象里面的元素的大小全部加起来才能达到我要的效果....
看来还需要亲自解决一些事情,于是:
public class ObjectSizeUtils {
private static Instrumentation inst = null;
public static void premain(String agentArgs, Instrumentation inst) {
ObjectSizeUtils.inst = inst;
}
public static long sizeOf(Object o) throws IllegalAccessException {
if(inst == null) throw new IllegalStateException("not initialized yet");
SizeCounter sizeCounter = new SizeCounter();
sizeOf(o, sizeCounter);
return sizeCounter.getSize();
}
public static void sizeOf(Object o,SizeCounter sizeCounter) throws IllegalAccessException {
if(o!=null){
sizeCounter.addSize(inst.getObjectSize(o));
Class c = o.getClass();
Field[] fields = c.getDeclaredFields();
for (Field f : fields) {
int mod = f.getModifiers();
if(Modifier.isStatic(mod) || f.getType().isPrimitive()){
continue;
}
f.setAccessible(true);
Object o1 = f.get(o);
sizeOf(o1,sizeCounter);
}
}
}
}
class SizeCounter{
private long size;
public long getSize() {
return size;
}
public void setSize(long size) {
this.size = size;
}
public void addSize(long size){
this.setSize(this.getSize() + size);
}
}
这段代码并不完整,还有很多因素并没有考虑进去,大体思路差不多就是这样。
以下是agent jar文件的Manifest Attributes:
Premain-Class
如果 JVM 启动时指定了代理,那么此属性指定代理类,即包含 premain 方法的类。如果 JVM 启动时指定了代理,那么此属性是必需的。如果该属性不存在,那么 JVM 将中止。注:此属性是类名,不是文件名或路径。
Agent-Class
如果实现支持 VM 启动之后某一时刻启动代理的机制,那么此属性指定代理类。 即包含 agentmain 方法的类。 此属性是必需的,如果不存在,代理将无法启动。 注:这是类名,而不是文件名或路径。
Boot-Class-Path
由引导类加载器搜索的路径列表。路径表示目录或库(在许多平台上通常作为 JAR 或 zip 库被引用)。查找类的特定于平台的机制失败后,引导类加载器会搜索这些路径。按列出的顺序搜索路径。列表中的路径由一个或多个空格分开。路径使用分层 URI 的路径组件语法。如果该路径以斜杠字符(“/”)开头,则为绝对路径,否则为相对路径。相对路径根据代理 JAR 文件的绝对路径解析。忽略格式不正确的路径和不存在的路径。如果代理是在 VM 启动之后某一时刻启动的,则忽略不表示 JAR 文件的路径。此属性是可选的。
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。