org.evosuite.testcase.execution

Class ExecutionTracer

java.lang.Object

org.evosuite.testcase.execution.ExecutionTracer

public class ExecutionTracer
extends Object

This class collects information about chosen branches/paths at runtime

Author:

Gordon Fraser

Method Summary

Modifier and Type	Method and Description
static void	checkTimeout() Called by the instrumented code each time a new source line is executed
void	clear() Reset for new execution
static void	disable() disable
static void	disableContext() disable context instrumentation
static void	disableTraceCalls() disableTraceCalls
static void	enable() enable
static void	enableContext() enable context instrumentation
static void	enableTraceCalls() enableTraceCalls
static void	enteredMethod(String classname, String methodname, Object caller) Called by instrumented code whenever a new method is called
static void	exceptionThrown(Object exception, String className, String methodName) exceptionThrown
static void	exitClassInit(String className) This method is added in the transformed bytecode
static ExecutionTracer	getExecutionTracer() getExecutionTracer
Throwable	getLastException() Return the last explicitly thrown exception
int	getNumStatementsExecuted() getNumStatementsExecuted
ExecutionTrace	getTrace() Return trace of current execution
static boolean	isEnabled() isEnabled
static boolean	isThreadNeqCurrentThread() Obviously more than one thread is executing during the creation of concurrent TestCases.
static boolean	isTraceCallsEnabled()
static void	leftMethod(String classname, String methodname) Called by instrumented code whenever a method is left
static void	passedBranch(int val, int opcode, int branch, int bytecode_id) Called by the instrumented code each time a new branch is taken
static void	passedBranch(int val1, int val2, int opcode, int branch, int bytecode_id) Called by the instrumented code each time a new branch is taken
static void	passedBranch(Object val, int opcode, int branch, int bytecode_id) Called by the instrumented code each time a new branch is taken
static void	passedBranch(Object val1, Object val2, int opcode, int branch, int bytecode_id) Called by the instrumented code each time a new branch is taken
static void	passedDefinition(Object object, Object caller, int defID) Called by instrumented code each time a variable gets written to (a Definition)
static void	passedFieldMethodCall(Object callee, Object caller, int defuseId) Called by instrumented code each time a field method call is passed Since it was not clear whether the field method call constitutes a definition or a use when the instrumentation was initially added this method will redirect the call accordingly
static void	passedGetStatic(String classNameWithDots, String fieldName)
static void	passedLine(String className, String methodName, int line) Called by the instrumented code each time a new source line is executed
static void	passedMutation(double distance, int mutationId) passedMutation
static void	passedPutStatic(String classNameWithDots, String fieldName)
static void	passedUnconditionalBranch(int opcode, int branch, int bytecode_id) Called by the instrumented code each time an unconditional branch is taken.
static void	passedUse(Object object, Object caller, int useID) Called by instrumented code each time a variable is read from (a Use)
static void	returnValue(int value, String className, String methodName) Called by instrumented code whenever a return values is produced
static void	returnValue(Object value, String className, String methodName) Called by instrumented code whenever a return values is produced
static void	setCheckCallerThread(boolean checkCallerThread) Setter for the field checkCallerThread.
static void	setKillSwitch(boolean value) Setter for the field killSwitch.
static void	setThread(Thread thread) setThread
static void	statementExecuted() statementExecuted

Methods inherited from class java.lang.Object

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

Method Detail

setThread

public static void setThread(Thread thread)

setThread

Parameters:

thread - a Thread object.

disable

public static void disable()

disable

enable

public static void enable()

enable

isEnabled

public static boolean isEnabled()

isEnabled

Returns:

a boolean.

setKillSwitch

public static void setKillSwitch(boolean value)

Setter for the field killSwitch.

Parameters:

value - a boolean.

setCheckCallerThread

public static void setCheckCallerThread(boolean checkCallerThread)

Setter for the field checkCallerThread.

Parameters:

checkCallerThread - a boolean.

enableContext

public static void enableContext()

enable context instrumentation

disableContext

public static void disableContext()

disable context instrumentation

disableTraceCalls

public static void disableTraceCalls()

disableTraceCalls

enableTraceCalls

public static void enableTraceCalls()

enableTraceCalls

isTraceCallsEnabled

public static boolean isTraceCallsEnabled()

getExecutionTracer

public static ExecutionTracer getExecutionTracer()

getExecutionTracer

Returns:

a ExecutionTracer object.

clear

public void clear()

Reset for new execution

isThreadNeqCurrentThread

public static boolean isThreadNeqCurrentThread()

Obviously more than one thread is executing during the creation of concurrent TestCases. #TODO steenbuck we should test if Thread.currentThread() is in the set of currently executing threads

Returns:

getTrace

public ExecutionTrace getTrace()

Return trace of current execution

Returns:

a ExecutionTrace object.

getLastException

public Throwable getLastException()

Return the last explicitly thrown exception

Returns:

a Throwable object.

enteredMethod

public static void enteredMethod(String classname,
                                 String methodname,
                                 Object caller)
                          throws TestCaseExecutor.TimeoutExceeded

Called by instrumented code whenever a new method is called

Parameters:

classname - a String object.

methodname - a String object.

caller - a Object object.

Throws:

org.evosuite.testcase.TestCaseExecutor$TimeoutExceeded - if any.

TestCaseExecutor.TimeoutExceeded

returnValue

public static void returnValue(int value,
                               String className,
                               String methodName)

Called by instrumented code whenever a return values is produced

Parameters:

value - a int.

className - a String object.

methodName - a String object.

returnValue

public static void returnValue(Object value,
                               String className,
                               String methodName)

Called by instrumented code whenever a return values is produced

Parameters:

value - a Object object.

className - a String object.

methodName - a String object.

leftMethod

public static void leftMethod(String classname,
                              String methodname)

Called by instrumented code whenever a method is left

Parameters:

classname - a String object.

methodname - a String object.

checkTimeout

public static void checkTimeout()

Called by the instrumented code each time a new source line is executed

passedLine

public static void passedLine(String className,
                              String methodName,
                              int line)

Called by the instrumented code each time a new source line is executed

Parameters:

line - a int.

className - a String object.

methodName - a String object.

passedUnconditionalBranch

public static void passedUnconditionalBranch(int opcode,
                                             int branch,
                                             int bytecode_id)

Called by the instrumented code each time an unconditional branch is taken. This is not enabled by default, only some coverage criteria (e.g., LCSAJ) use it.

Parameters:

opcode - a int.

branch - a int.

bytecode_id - a int.

passedBranch

public static void passedBranch(int val,
                                int opcode,
                                int branch,
                                int bytecode_id)

Called by the instrumented code each time a new branch is taken

Parameters:

val - a int.

opcode - a int.

branch - a int.

bytecode_id - a int.

passedPutStatic

public static void passedPutStatic(String classNameWithDots,
                                   String fieldName)

exitClassInit

public static void exitClassInit(String className)

This method is added in the transformed bytecode

Parameters:

className -

passedGetStatic

public static void passedGetStatic(String classNameWithDots,
                                   String fieldName)

Parameters:

classNameWithDots -

fieldName -

passedBranch

public static void passedBranch(int val1,
                                int val2,
                                int opcode,
                                int branch,
                                int bytecode_id)

Called by the instrumented code each time a new branch is taken

Parameters:

val1 - a int.

val2 - a int.

opcode - a int.

branch - a int.

bytecode_id - a int.

passedBranch

public static void passedBranch(Object val1,
                                Object val2,
                                int opcode,
                                int branch,
                                int bytecode_id)

Called by the instrumented code each time a new branch is taken

Parameters:

val1 - a Object object.

val2 - a Object object.

opcode - a int.

branch - a int.

bytecode_id - a int.

passedBranch

public static void passedBranch(Object val,
                                int opcode,
                                int branch,
                                int bytecode_id)

Called by the instrumented code each time a new branch is taken

Parameters:

val - a Object object.

opcode - a int.

branch - a int.

bytecode_id - a int.

passedDefinition

public static void passedDefinition(Object object,
                                    Object caller,
                                    int defID)

Called by instrumented code each time a variable gets written to (a Definition)

Parameters:

caller - a Object object.

defID - a int.

passedUse

public static void passedUse(Object object,
                             Object caller,
                             int useID)

Called by instrumented code each time a variable is read from (a Use)

Parameters:

caller - a Object object.

useID - a int.

passedFieldMethodCall

public static void passedFieldMethodCall(Object callee,
                                         Object caller,
                                         int defuseId)

Called by instrumented code each time a field method call is passed Since it was not clear whether the field method call constitutes a definition or a use when the instrumentation was initially added this method will redirect the call accordingly

Parameters:

caller -

defuseId -

passedMutation

public static void passedMutation(double distance,
                                  int mutationId)

passedMutation

Parameters:

distance - a double.

mutationId - a int.

exceptionThrown

public static void exceptionThrown(Object exception,
                                   String className,
                                   String methodName)

exceptionThrown

Parameters:

exception - a Object object.

className - a String object.

methodName - a String object.

statementExecuted

public static void statementExecuted()

statementExecuted

getNumStatementsExecuted

public int getNumStatementsExecuted()

getNumStatementsExecuted

Returns:

a int.