Package javassist.tools
Class Callback
- java.lang.Object
-
- javassist.tools.Callback
-
public abstract class Callback extends java.lang.Object
Creates bytecode that when executed calls back to the instance's result method.Example of how to create and insert a callback:
ctMethod.insertAfter(new Callback("Thread.currentThread()") { public void result(Object[] objects) { Thread thread = (Thread) objects[0]; // do something with thread... } }.sourceCode());
Contains utility methods for inserts callbacks in
CtBehaviour
, example:insertAfter(ctBehaviour, new Callback("Thread.currentThread(), dummyString") { public void result(Object[] objects) { Thread thread = (Thread) objects[0]; // do something with thread... } });
- Author:
- Marten Hedborg, Shigeru Chiba
-
-
Constructor Summary
Constructors Constructor Description Callback(java.lang.String src)
Constructs a newCallback
object.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description static void
insertAfter(CtBehavior behavior, Callback callback)
Utility method to inserts callback at the end of the body.static void
insertAfter(CtBehavior behavior, Callback callback, boolean asFinally)
Utility method to inserts callback at the end of the body.static int
insertAt(CtBehavior behavior, Callback callback, int lineNum)
Utility method to inserts callback at the specified line in the body.static void
insertBefore(CtBehavior behavior, Callback callback)
Utility method to insert callback at the beginning of the body.abstract void
result(java.lang.Object[] objects)
Gets called when bytecode is executedjava.lang.String
sourceCode()
java.lang.String
toString()
-
-
-
Field Detail
-
callbacks
public static java.util.Map<java.lang.String,Callback> callbacks
-
-
Constructor Detail
-
Callback
public Callback(java.lang.String src)
Constructs a newCallback
object.- Parameters:
src
- The source code representing the inserted callback bytecode. Can be one or many single statements each returning one object. If many single statements are used they must be comma separated.
-
-
Method Detail
-
result
public abstract void result(java.lang.Object[] objects)
Gets called when bytecode is executed- Parameters:
objects
- Objects that the bytecode in callback returns
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
sourceCode
public java.lang.String sourceCode()
-
insertBefore
public static void insertBefore(CtBehavior behavior, Callback callback) throws CannotCompileException
Utility method to insert callback at the beginning of the body.- Parameters:
callback
- The callback- Throws:
CannotCompileException
- See Also:
CtBehavior.insertBefore(String)
-
insertAfter
public static void insertAfter(CtBehavior behavior, Callback callback) throws CannotCompileException
Utility method to inserts callback at the end of the body. The callback is inserted just before every return instruction. It is not executed when an exception is thrown.- Parameters:
behavior
- The behaviour to insert callback incallback
- The callback- Throws:
CannotCompileException
- See Also:
CtBehavior.insertAfter(String, boolean)
-
insertAfter
public static void insertAfter(CtBehavior behavior, Callback callback, boolean asFinally) throws CannotCompileException
Utility method to inserts callback at the end of the body. The callback is inserted just before every return instruction. It is not executed when an exception is thrown.- Parameters:
behavior
- The behaviour to insert callback incallback
- The callback representing the inserted.asFinally
- True if the inserted is executed Not only when the control normally returns but also when an exception is thrown. If this parameter is true, the inserted code cannot access local variables.- Throws:
CannotCompileException
- See Also:
CtBehavior.insertAfter(String, boolean)
-
insertAt
public static int insertAt(CtBehavior behavior, Callback callback, int lineNum) throws CannotCompileException
Utility method to inserts callback at the specified line in the body.- Parameters:
behavior
- The behaviour to insert callback incallback
- The callback representing.lineNum
- The line number. The callback is inserted at the beginning of the code at the line specified by this line number.- Returns:
- The line number at which the callback has been inserted.
- Throws:
CannotCompileException
- See Also:
CtBehavior.insertAt(int, String)
-
-