at.chrl.callbacks.JavaAgentEnhancer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of chrl-callbacks Show documentation

Callback Framework to hook up on method calls with annotations

There is a newer version: 1.1.0

/**
 * This file is part of aion-lightning .
 * 
 * aion-lightning is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation, either version 3 of the License, or (at your option) any
 * later version.
 * 
 * aion-lightning is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU General Public License along with
 * aion-lightning. If not, see .
 */
package at.chrl.callbacks;

import java.lang.instrument.Instrumentation;

import at.chrl.callbacks.enhancer.GlobalCallbackEnhancer;
import at.chrl.callbacks.enhancer.ObjectCallbackEnhancer;

/**
 * This class is used as javaagent to do on-class-load transformations with
 * objects whose methods are marked by
 * {@link at.chrl.callbacks.metadata.ObjectCallback} or
 * {@link at.chrl.callbacks.metadata.GlobalCallback} annotation.

 * Code is inserted dynamicly before method call and after method call.

 * For implementation docs please reffer to:
 * http://www.csg.is.titech.ac.jp/~chiba/javassist/tutorial/tutorial2.html

 * 

 * Usage: java -javaagent:lib/ae_commons.jar
 *
 * @author SoulKeeper
 */
public class JavaAgentEnhancer {

	/**
	 * Premain method that registers this class as ClassFileTransformer
	 *
	 * @param args
	 *            arguments passed to javaagent, ignored
	 * @param instrumentation
	 *            Instrumentation object
	 */
	public static void premain(String args, Instrumentation instrumentation) {
		instrumentation.addTransformer(new ObjectCallbackEnhancer(), true);
		instrumentation.addTransformer(new GlobalCallbackEnhancer(), true);
	}
}