io.devcon5.classutils

Class CallStack

java.lang.Object

io.devcon5.classutils.CallStack

public final class CallStack
extends Object

Helper class for operations on the call stack Created by Gerald Muecke on 26.11.2015.

Method Summary

Modifier and Type	Method and Description
static Optional<Method>	currentMethod() Returns a reference to a method that was last invoked on a target object which has been enhanced for method recording.
static Class<?>	getCallerClass() Returns the caller class of the calling method. For example: A.calling() -> B.called() B.called() -> getCallerClass(): A If a thread context classloader is defined, it will be used for loading the class, otherwise the default class loader is used.
static <T> T	track(T target) Enhances the target object to track the invocation of methods of the target.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

track

public static <T> T track(T target)

Enhances the target object to track the invocation of methods of the target. The current method can be retrieved by invoking currentMethod()

Type Parameters:

T - the type of the tracked object

Parameters:

target - the target object whose method invocations should be tracked

Returns:

a tracked object whose method references will be put onto a stack so that the most recent method can be retrieved using the currentMethod() call

currentMethod

public static Optional<Method> currentMethod()

Returns a reference to a method that was last invoked on a target object which has been enhanced for method recording. This method only works properly if the caller of this method is tracked.

Returns:

the current method on the tracked call stack or an empty optional if no method was found, i.e. because no object on the actual callstack is tracked.

getCallerClass

public static Class<?> getCallerClass()

Returns the caller class of the calling method.
For example:
A.calling() -> B.called() B.called() -> getCallerClass(): A
If a thread context classloader is defined, it will be used for loading the class, otherwise the default class loader is used.

Returns:

the class of the calling method's class