ExecutionTrace (evosuite-client 1.0.5 API)

All Known Implementing Classes:

ExecutionTraceImpl, ExecutionTraceProxy
```
public interface ExecutionTrace
```
This interface defines the trace data that is collected during execution.

Author:

Gordon Fraser

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`branchPassed(int branch, int bytecode_id, double true_distance, double false_distance)` Add branch to currently active method call
`void`	`classInitialized(String classNameWithDots)` Logs that a was completed during this test execution
`void`	`clear()` Reset to 0
`void`	`definitionPassed(Object object, Object caller, int defID)` Adds Definition-Use-Coverage trace information for the given definition.
`void`	`enteredMethod(String className, String methodName, Object caller)` Add a new method call to stack
`void`	`exitMethod(String classname, String methodname)` Pop last method call from stack
`void`	`finishCalls()` Finish all method calls.
`Set<Integer>`	`getAllCoveredLines()` Retrieve the set of all line numbers covered
`List<ExecutionTraceImpl.BranchEval>`	`getBranchesTrace()` getBranchesTrace
`Set<String>`	`getClassesWithStaticReads()` Retrieve a list of those classes that were affected by a GETSTATIC.
`Set<String>`	`getClassesWithStaticWrites()` Retrieve a list of those classes that were affected by a PUTSTATIC.
`Map<String,Map<String,Map<Integer,Integer>>>`	`getCoverageData()` Retrieve detailed line coverage count
`Set<String>`	`getCoveredBranchlessMethods()` Retrieve the names of all covered branchless methods
`Set<Integer>`	`getCoveredDefinitions()` Retrieve set of definitions that were executed
`Set<Integer>`	`getCoveredFalseBranches()` Retrieve set of branches that evaluated to false
`Set<Integer>`	`getCoveredLines()` Retrieve the set of line numbers covered of `Properties.TARGET_CLASS` class
`Set<Integer>`	`getCoveredLines(String className)` Retrieve the set of line numbers covered
`Set<String>`	`getCoveredMethods()` Retrieve the names of all called methods
`Set<Integer>`	`getCoveredPredicates()` Retrieve set of branches that were executed
`Set<Integer>`	`getCoveredTrueBranches()` Retrieve set of branches that evaluated to true
`Map<String,HashMap<Integer,HashMap<Integer,Integer>>>`	`getDefinitionData()` Retrieve data definitions
`Map<String,HashMap<Integer,HashMap<Integer,Object>>>`	`getDefinitionDataObjects()` Retrieve data definitions
`Map<Integer,Integer>`	`getDefinitionExecutionCount()` Retrieve execution counts for definitions
`Throwable`	`getExplicitException()` Retrieve the exception thrown in this trace
`double`	`getFalseDistance(int branchId)` Retrieve minimum branch distance to false branch
`Map<Integer,Double>`	`getFalseDistances()` Retrieve map of all minimal false distances
`Map<Integer,Map<CallContext,Double>>`	`getFalseDistancesContext()` Retrieve map of all minimal false distances
`Map<Integer,Double>`	`getFalseDistancesSum()` getFalseDistancesSum
`Set<Integer>`	`getInfectedMutants()` Retrieve IDs of all executed mutants with an infection distance == 0.0
`List<String>`	`getInitializedClasses()` Returns the list (with no repetitions) following the order in which the method was finished during this test execution
`List<MethodCall>`	`getMethodCalls()` Retrieve all traced method calls
`Map<String,Map<CallContext,Integer>>`	`getMethodContextCount()` Retrieve map of all context method counts
`Map<String,Integer>`	`getMethodExecutionCount()` Retrieve execution counts for methods
`double`	`getMutationDistance(int mutationId)` Retrieve the minimum infection distance for a mutant
`Map<Integer,Double>`	`getMutationDistances()` Retrieve all minimal infection distances
`Set<Integer>`	`getPassedDefIDs()` Deprecated.
`Map<Integer,HashMap<Integer,Integer>>`	`getPassedDefinitions(String variableName)` Retrieve the data definitions for a given variable
`Set<Integer>`	`getPassedUseIDs()` Retrieve the set of all uses by id
`Map<String,HashMap<Integer,HashMap<Integer,Integer>>>`	`getPassedUses()` getPassedUses
`Map<Integer,HashMap<Integer,Integer>>`	`getPassedUses(String variableName)` Retrieve the data uses for a given variable
`Map<Integer,Map<CallContext,Integer>>`	`getPredicateContextExecutionCount()` Retrieve number of predicate executions
`Map<Integer,Integer>`	`getPredicateExecutionCount()` Retrieve execution counts for branches
`Map<String,Map<String,Map<Integer,Integer>>>`	`getReturnData()` Retrieve return value data
`void`	`getStaticPassed(String classNameWithDots, String fieldName)` Record a GETSTATIC statement
`Set<Integer>`	`getTouchedMutants()` Retrieve IDs of all executed mutants
`ExecutionTrace`	`getTraceForObject(int objectId)` Returns a copy of this trace where all MethodCall-information traced from objects other then the one identified by the given objectID is removed from the finished_calls-field WARNING: this will not affect this.true_distances and other fields of ExecutionTrace this only affects the finished_calls field (which should suffice for BranchCoverageFitness-calculation)
`ExecutionTrace`	`getTraceInDUCounterRange(DefUse targetDU, boolean wantToCoverTargetDU, int duCounterStart, int duCounterEnd)` Returns a copy of this trace where all MethodCall-information associated with duCounters outside the range of the given duCounter-Start and -End is removed from the finished_calls-traces finished_calls without any point in the trace at which the given duCounter range is hit are removed completely Also traces for methods other then the one that holds the given targetDU are removed as well as trace information that would pass the branch of the given targetDU If wantToCoverTargetDU is false instead those targetDUBranch information is removed that would pass the alternative branch of targetDU The latter is because this method only gets called when the given targetDU was not active in the given duCounter-range if and only if wantToCoverTargetDU is set, and since useFitness calculation is on branch level and the branch of the targetDU can be passed before the targetDU is passed this can lead to a flawed branchFitness.
`double`	`getTrueDistance(int branchId)` Retrieve minimum branch distance to true branch
`Map<Integer,Double>`	`getTrueDistances()` Retrieve map of all minimal true distances
`Map<Integer,Map<CallContext,Double>>`	`getTrueDistancesContext()` Retrieve map of all minimal true distances
`Map<Integer,Double>`	`getTrueDistancesSum()` getTrueDistancesSum
`Map<String,HashMap<Integer,HashMap<Integer,Integer>>>`	`getUseData()` Retrieve data uses
`Map<String,HashMap<Integer,HashMap<Integer,Object>>>`	`getUseDataObjects()` Retrieve data uses
`boolean`	`hasFalseDistance(int predicateId)` Determine if a branch has a false distance stored
`boolean`	`hasTrueDistance(int predicateId)` Determine if a branch has a true distance stored
`ExecutionTrace`	`lazyClone()` Create a lazy copy
`void`	`linePassed(String className, String methodName, int line)` Add line to currently active method call
`void`	`mutationPassed(int mutationId, double distance)` Record a mutant execution
`void`	`putStaticPassed(String classNameWithDots, String fieldName)` Record a PUTSTATIC statement
`void`	`returnValue(String className, String methodName, int value)` Record a return value
`void`	`setExplicitException(Throwable explicitException)` Set the exception thrown in this trace
`String`	`toDefUseTraceInformation()` Returns a String containing the information in passedDefs and passedUses Used for Definition-Use-Coverage-debugging
`String`	`toDefUseTraceInformation(String targetVar)` Returns a String containing the information in passedDefs and passedUses filtered for a specific variable Used for Definition-Use-Coverage-debugging
`String`	`toDefUseTraceInformation(String var, int objectId)` Returns a String containing the information in passedDefs and passedUses for the given variable Used for Definition-Use-Coverage-debugging
`void`	`usePassed(Object object, Object caller, int useID)` Adds Definition-Use-Coverage trace information for the given use.
`boolean`	`wasMutationTouched(int mutationId)` Determine is a mutant was executed

- Method Detail
  - branchPassed
```
void branchPassed(int branch,
                  int bytecode_id,
                  double true_distance,
                  double false_distance)
```
    Add branch to currently active method call
    
    Parameters:
    
    branch - a int.
    
    true_distance - a double.
    
    false_distance - a double.
    
    bytecode_id - a int.
  - getFalseDistance
```
double getFalseDistance(int branchId)
```
    Retrieve minimum branch distance to false branch
    
    Parameters:
    
    branchId - a int.
    
    Returns:
    
    a double.
  - getTrueDistance
```
double getTrueDistance(int branchId)
```
    Retrieve minimum branch distance to true branch
    
    Parameters:
    
    branchId - a int.
    
    Returns:
    
    a double.
  - getCoveredTrueBranches
```
Set<Integer> getCoveredTrueBranches()
```
    Retrieve set of branches that evaluated to true
    
    Returns:
    
    a Set object.
  - getCoveredFalseBranches
```
Set<Integer> getCoveredFalseBranches()
```
    Retrieve set of branches that evaluated to false
    
    Returns:
    
    a Set object.
  - getCoveredPredicates
```
Set<Integer> getCoveredPredicates()
```
    Retrieve set of branches that were executed
    
    Returns:
    
    a Set object.
  - getCoveredDefinitions
```
Set<Integer> getCoveredDefinitions()
```
    Retrieve set of definitions that were executed
    
    Returns:
    
    a Set object.
  - getPredicateExecutionCount
```
Map<Integer,Integer> getPredicateExecutionCount()
```
    Retrieve execution counts for branches
    
    Returns:
    
    a Map object.
  - getMethodExecutionCount
```
Map<String,Integer> getMethodExecutionCount()
```
    Retrieve execution counts for methods
    
    Returns:
    
    a Map object.
  - getDefinitionExecutionCount
```
Map<Integer,Integer> getDefinitionExecutionCount()
```
    Retrieve execution counts for definitions
    
    Returns:
    
    a Map object.
  - hasTrueDistance
```
boolean hasTrueDistance(int predicateId)
```
    Determine if a branch has a true distance stored
    
    Parameters:
    
    predicateId - a int.
    
    Returns:
    
    a boolean.
  - hasFalseDistance
```
boolean hasFalseDistance(int predicateId)
```
    Determine if a branch has a false distance stored
    
    Parameters:
    
    predicateId - a int.
    
    Returns:
    
    a boolean.
  - getTrueDistances
```
Map<Integer,Double> getTrueDistances()
```
    Retrieve map of all minimal true distances
    
    Returns:
    
    a Map object.
  - getFalseDistances
```
Map<Integer,Double> getFalseDistances()
```
    Retrieve map of all minimal false distances
    
    Returns:
    
    a Map object.
  - getTrueDistancesContext
```
Map<Integer,Map<CallContext,Double>> getTrueDistancesContext()
```
    Retrieve map of all minimal true distances
    
    Returns:
    
    a Map object.
  - getFalseDistancesContext
```
Map<Integer,Map<CallContext,Double>> getFalseDistancesContext()
```
    Retrieve map of all minimal false distances
    
    Returns:
    
    a Map object.
  - getMethodContextCount
```
Map<String,Map<CallContext,Integer>> getMethodContextCount()
```
    Retrieve map of all context method counts
    
    Returns:
    
    a Map object.
  - getPredicateContextExecutionCount
```
Map<Integer,Map<CallContext,Integer>> getPredicateContextExecutionCount()
```
    Retrieve number of predicate executions
    
    Returns:
    
    a Map object.
  - getCoveredLines
```
Set<Integer> getCoveredLines(String className)
```
    Retrieve the set of line numbers covered
    
    Parameters:
    
    className - a String object.
    
    Returns:
    
    a Set object.
  - getCoveredLines
```
Set<Integer> getCoveredLines()
```
    Retrieve the set of line numbers covered of Properties.TARGET_CLASS class
    
    Returns:
    
    a Set object.
  - getAllCoveredLines
```
Set<Integer> getAllCoveredLines()
```
    Retrieve the set of all line numbers covered
    
    Returns:
  - getCoverageData
```
Map<String,Map<String,Map<Integer,Integer>>> getCoverageData()
```
    Retrieve detailed line coverage count
    
    Returns:
    
    a Map object.
  - getReturnData
```
Map<String,Map<String,Map<Integer,Integer>>> getReturnData()
```
    Retrieve return value data
    
    Returns:
    
    a Map object.
  - getDefinitionData
```
Map<String,HashMap<Integer,HashMap<Integer,Integer>>> getDefinitionData()
```
    Retrieve data definitions
    
    Returns:
    
    a Map object.
  - getDefinitionDataObjects
```
Map<String,HashMap<Integer,HashMap<Integer,Object>>> getDefinitionDataObjects()
```
    Retrieve data definitions
    
    Returns:
    
    a Map object.
  - getUseData
```
Map<String,HashMap<Integer,HashMap<Integer,Integer>>> getUseData()
```
    Retrieve data uses
    
    Returns:
    
    a Map object.
  - getUseDataObjects
```
Map<String,HashMap<Integer,HashMap<Integer,Object>>> getUseDataObjects()
```
    Retrieve data uses
    
    Returns:
    
    a Map object.
  - getPassedDefinitions
```
Map<Integer,HashMap<Integer,Integer>> getPassedDefinitions(String variableName)
```
    Retrieve the data definitions for a given variable
    
    Parameters:
    
    variableName - a String object.
    
    Returns:
    
    a Map object.
  - getPassedUses
```
Map<Integer,HashMap<Integer,Integer>> getPassedUses(String variableName)
```
    Retrieve the data uses for a given variable
    
    Parameters:
    
    variableName - a String object.
    
    Returns:
    
    a Map object.
  - getExplicitException
```
Throwable getExplicitException()
```
    Retrieve the exception thrown in this trace
    
    Returns:
    
    a Throwable object.
  - getMethodCalls
```
List<MethodCall> getMethodCalls()
```
    Retrieve all traced method calls
    
    Returns:
    
    a List object.
  - getCoveredMethods
```
Set<String> getCoveredMethods()
```
    Retrieve the names of all called methods
    
    Returns:
    
    a Set object.
  - getCoveredBranchlessMethods
```
Set<String> getCoveredBranchlessMethods()
```
    Retrieve the names of all covered branchless methods
    
    Returns:
    
    a Set object.
  - getMutationDistance
```
double getMutationDistance(int mutationId)
```
    Retrieve the minimum infection distance for a mutant
    
    Parameters:
    
    mutationId - a int.
    
    Returns:
    
    a double.
  - getMutationDistances
```
Map<Integer,Double> getMutationDistances()
```
    Retrieve all minimal infection distances
    
    Returns:
    
    a Map object.
  - wasMutationTouched
```
boolean wasMutationTouched(int mutationId)
```
    Determine is a mutant was executed
    
    Parameters:
    
    mutationId - a int.
    
    Returns:
    
    a boolean.
  - getTouchedMutants
```
Set<Integer> getTouchedMutants()
```
    Retrieve IDs of all executed mutants
    
    Returns:
    
    a Set object.
  - getInfectedMutants
```
Set<Integer> getInfectedMutants()
```
    Retrieve IDs of all executed mutants with an infection distance == 0.0
    
    Returns:
    
    a Set object.
  - clear
```
void clear()
```
    Reset to 0
  - definitionPassed
```
void definitionPassed(Object object,
                      Object caller,
                      int defID)
```
    Adds Definition-Use-Coverage trace information for the given definition. Registers the given caller-Object Traces the occurrence of the given definition in the passedDefs-field Sets the given definition as the currently active one for the definitionVariable in the activeDefinitions-field Adds fake trace information to the currently active MethodCall in this.stack
    
    Parameters:
    
    caller - a Object object.
    
    defID - a int.
  - enteredMethod
```
void enteredMethod(String className,
                   String methodName,
                   Object caller)
```
    Add a new method call to stack
    
    Parameters:
    
    className - a String object.
    
    methodName - a String object.
    
    caller - a Object object.
  - exitMethod
```
void exitMethod(String classname,
                String methodname)
```
    Pop last method call from stack
    
    Parameters:
    
    classname - a String object.
    
    methodname - a String object.
  - finishCalls
```
void finishCalls()
```
    Finish all method calls. This is called when a method is not exited regularly, but through an exception
  - getTraceForObject
```
ExecutionTrace getTraceForObject(int objectId)
```
    Returns a copy of this trace where all MethodCall-information traced from objects other then the one identified by the given objectID is removed from the finished_calls-field WARNING: this will not affect this.true_distances and other fields of ExecutionTrace this only affects the finished_calls field (which should suffice for BranchCoverageFitness-calculation)
    
    Parameters:
    
    objectId - a int.
    
    Returns:
    
    a ExecutionTrace object.
  - getTraceInDUCounterRange
```
ExecutionTrace getTraceInDUCounterRange(DefUse targetDU,
                                        boolean wantToCoverTargetDU,
                                        int duCounterStart,
                                        int duCounterEnd)
```
    Returns a copy of this trace where all MethodCall-information associated with duCounters outside the range of the given duCounter-Start and -End is removed from the finished_calls-traces finished_calls without any point in the trace at which the given duCounter range is hit are removed completely Also traces for methods other then the one that holds the given targetDU are removed as well as trace information that would pass the branch of the given targetDU If wantToCoverTargetDU is false instead those targetDUBranch information is removed that would pass the alternative branch of targetDU The latter is because this method only gets called when the given targetDU was not active in the given duCounter-range if and only if wantToCoverTargetDU is set, and since useFitness calculation is on branch level and the branch of the targetDU can be passed before the targetDU is passed this can lead to a flawed branchFitness. WARNING: this will not affect this.true_distances and other fields of ExecutionTrace this only affects the finished_calls field (which should suffice for BranchCoverageFitness-calculation)
    
    Parameters:
    
    targetDU - a DefUse object.
    
    wantToCoverTargetDU - a boolean.
    
    duCounterStart - a int.
    
    duCounterEnd - a int.
    
    Returns:
    
    a ExecutionTrace object.
  - linePassed
```
void linePassed(String className,
                String methodName,
                int line)
```
    Add line to currently active method call
    
    Parameters:
    
    line - a int.
    
    className - a String object.
    
    methodName - a String object.
  - mutationPassed
```
void mutationPassed(int mutationId,
                    double distance)
```
    Record a mutant execution
    
    Parameters:
    
    mutationId - a int.
    
    distance - a double.
  - returnValue
```
void returnValue(String className,
                 String methodName,
                 int value)
```
    Record a return value
    
    Parameters:
    
    className - a String object.
    
    methodName - a String object.
    
    value - a int.
  - toDefUseTraceInformation
```
String toDefUseTraceInformation()
```
    Returns a String containing the information in passedDefs and passedUses Used for Definition-Use-Coverage-debugging
    
    Returns:
    
    a String object.
  - toDefUseTraceInformation
```
String toDefUseTraceInformation(String targetVar)
```
    Returns a String containing the information in passedDefs and passedUses filtered for a specific variable Used for Definition-Use-Coverage-debugging
    
    Parameters:
    
    targetVar - a String object.
    
    Returns:
    
    a String object.
  - toDefUseTraceInformation
```
String toDefUseTraceInformation(String var,
                                int objectId)
```
    Returns a String containing the information in passedDefs and passedUses for the given variable Used for Definition-Use-Coverage-debugging
    
    Parameters:
    
    var - a String object.
    
    objectId - a int.
    
    Returns:
    
    a String object.
  - usePassed
```
void usePassed(Object object,
               Object caller,
               int useID)
```
    Adds Definition-Use-Coverage trace information for the given use. Registers the given caller-Object Traces the occurrence of the given use in the passedUses-field
    
    Parameters:
    
    caller - a Object object.
    
    useID - a int.
  - setExplicitException
```
void setExplicitException(Throwable explicitException)
```
    Set the exception thrown in this trace
    
    Parameters:
    
    explicitException - a Throwable object.
  - lazyClone
```
ExecutionTrace lazyClone()
```
    Create a lazy copy
    
    Returns:
    
    a ExecutionTrace object.
  - getBranchesTrace
```
List<ExecutionTraceImpl.BranchEval> getBranchesTrace()
```
    getBranchesTrace
    
    Returns:
    
    a List object.
  - getFalseDistancesSum
```
Map<Integer,Double> getFalseDistancesSum()
```
    getFalseDistancesSum
    
    Returns:
    
    a Map object.
  - getTrueDistancesSum
```
Map<Integer,Double> getTrueDistancesSum()
```
    getTrueDistancesSum
    
    Returns:
    
    a Map object.
  - getPassedUses
```
Map<String,HashMap<Integer,HashMap<Integer,Integer>>> getPassedUses()
```
    getPassedUses
    
    Returns:
    
    a Map object.
  - getPassedUseIDs
```
Set<Integer> getPassedUseIDs()
```
    Retrieve the set of all uses by id
    
    Returns:
  - getPassedDefIDs
```
@Deprecated
Set<Integer> getPassedDefIDs()
```
    Deprecated.
    
    Retrieve the set of all definitions by id
    
    Returns:
  - putStaticPassed
```
void putStaticPassed(String classNameWithDots,
                     String fieldName)
```
    Record a PUTSTATIC statement
    
    Parameters:
    
    classNameWithDots -
    
    fieldName -
  - getStaticPassed
```
void getStaticPassed(String classNameWithDots,
                     String fieldName)
```
    Record a GETSTATIC statement
    
    Parameters:
    
    classNameWithDots -
    
    fieldName -
  - getClassesWithStaticWrites
```
Set<String> getClassesWithStaticWrites()
```
    Retrieve a list of those classes that were affected by a PUTSTATIC.
    
    Returns:
  - getClassesWithStaticReads
```
Set<String> getClassesWithStaticReads()
```
    Retrieve a list of those classes that were affected by a GETSTATIC.
    
    Returns:
  - classInitialized
```
void classInitialized(String classNameWithDots)
```
    Logs that a was completed during this test execution
    
    Parameters:
    
    classNameWithDots -
  - getInitializedClasses
```
List<String> getInitializedClasses()
```
    Returns the list (with no repetitions) following the order in which the method was finished during this test execution
    
    Returns:

Interface ExecutionTrace

Method Summary

Method Detail

branchPassed

getFalseDistance

getTrueDistance

getCoveredTrueBranches

getCoveredFalseBranches

getCoveredPredicates

getCoveredDefinitions

getPredicateExecutionCount

getMethodExecutionCount

getDefinitionExecutionCount

hasTrueDistance

hasFalseDistance

getTrueDistances

getFalseDistances

getTrueDistancesContext

getFalseDistancesContext

getMethodContextCount

getPredicateContextExecutionCount

getCoveredLines

getCoveredLines

getAllCoveredLines

getCoverageData

getReturnData

getDefinitionData

getDefinitionDataObjects

getUseData

getUseDataObjects

getPassedDefinitions

getPassedUses

getExplicitException

getMethodCalls

getCoveredMethods

getCoveredBranchlessMethods

getMutationDistance

getMutationDistances

wasMutationTouched

getTouchedMutants

getInfectedMutants

clear

definitionPassed

enteredMethod

exitMethod

finishCalls

getTraceForObject

getTraceInDUCounterRange

linePassed

mutationPassed

returnValue

toDefUseTraceInformation

toDefUseTraceInformation

toDefUseTraceInformation

usePassed

setExplicitException

lazyClone

getBranchesTrace

getFalseDistancesSum

getTrueDistancesSum

getPassedUses

getPassedUseIDs

getPassedDefIDs

putStaticPassed

getStaticPassed

getClassesWithStaticWrites

getClassesWithStaticReads

classInitialized

getInitializedClasses