org.evosuite.setup

Class TestCluster

java.lang.Object

org.evosuite.setup.TestCluster

public class TestCluster
extends Object

Author:

Gordon Fraser

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	logger

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TestCluster()

Method Summary

Modifier and Type	Method and Description
void	addCastClassForContainer(Class<?> clazz) Add a new class observed at runtime for container methods
void	addEnvironmentTestCall(GenericAccessibleObject<?> call)
void	addGenerator(GenericClass target, GenericAccessibleObject<?> call) Add a generator reflection object
void	addModifier(GenericClass target, GenericAccessibleObject<?> call) Add a modifier reflection object
void	addTestCall(GenericAccessibleObject<?> call) Add a test call
void	clearGeneratorCache(GenericClass target) Forget everything we have cached
Set<Class<?>>	getAnalyzedClasses() Deprecated.
Set<GenericAccessibleObject<?>>	getCallsFor(GenericClass clazz, boolean resolve) Return all calls that have a parameter with given type
Class<?>	getClass(String name) Find a class that matches the given name
Set<GenericAccessibleObject<?>>	getGenerators() Retrieve all generators
Set<GenericAccessibleObject<?>>	getGenerators(GenericClass clazz, boolean resolve) Get a list of all generator objects for the type
static InheritanceTree	getInheritanceTree()
static TestCluster	getInstance() Instance accessor
Collection<Class<?>>	getKnownMatchingClasses(String name) Retrieve all classes that match the given postfix
Set<GenericAccessibleObject<?>>	getModifiers() Retrieve all modifiers
int	getNumOfEnvironmentCalls()
int	getNumTestCalls()
Set<GenericAccessibleObject<?>>	getObjectGenerators() Determine the set of generators for an Object.class instance
GenericAccessibleObject<?>	getRandomCallFor(GenericClass clazz, TestCase test, int position)
GenericAccessibleObject<?>	getRandomGenerator(GenericClass clazz) Randomly select one generator
GenericAccessibleObject<?>	getRandomGenerator(GenericClass clazz, Set<GenericAccessibleObject<?>> excluded, TestCase test, int position, VariableReference generatorRefToExclude, int recursionDepth) Randomly select one generator
List<GenericAccessibleObject<?>>	getRandomizedCallsToEnvironment()
GenericAccessibleObject<?>	getRandomObjectGenerator() Randomly select a generator for an Object.class instance
GenericAccessibleObject<?>	getRandomTestCall(TestCase test) Get random method or constructor of unit under test
List<GenericAccessibleObject<?>>	getTestCalls() Get a list of all test calls (i.e., constructors and methods)
void	handleRuntimeAccesses(TestCase test)
boolean	hasGenerator(GenericClass clazz) Determine if there are generators
boolean	hasGenerator(Type type) Determine if there are generators
Class<?>	importClass(String name) Integrate a new class into the test cluster
void	invalidateGeneratorCache(GenericClass klass)
static boolean	isTargetClassName(String className)
void	removeTestCall(GenericAccessibleObject<?> call)
void	removeUnusableGenerators() A generator for X might be a non-static method M of Y, but what if Y itself has no generator? In that case, M should not be a generator for X, as it is impossible to instantiate Y
static void	reset()
protected static void	setInheritanceTree(InheritanceTree inheritancetree)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final org.slf4j.Logger logger

Constructor Detail

TestCluster

protected TestCluster()

Method Detail

getInstance

public static TestCluster getInstance()

Instance accessor

Returns:

reset

public static void reset()

removeUnusableGenerators

public void removeUnusableGenerators()

A generator for X might be a non-static method M of Y, but what if Y itself has no generator? In that case, M should not be a generator for X, as it is impossible to instantiate Y

invalidateGeneratorCache

public void invalidateGeneratorCache(GenericClass klass)

handleRuntimeAccesses

public void handleRuntimeAccesses(TestCase test)

getInheritanceTree

public static InheritanceTree getInheritanceTree()

Returns:

the inheritancetree

setInheritanceTree

protected static void setInheritanceTree(InheritanceTree inheritancetree)

Parameters:

inheritancetree - the inheritancetree to set

isTargetClassName

public static boolean isTargetClassName(String className)

addGenerator

public void addGenerator(GenericClass target,
                         GenericAccessibleObject<?> call)

Add a generator reflection object

Parameters:

target - is assumed to have wildcard types

call -

addModifier

public void addModifier(GenericClass target,
                        GenericAccessibleObject<?> call)

Add a modifier reflection object

Parameters:

target - is assumed to have wildcard types

call -

addTestCall

public void addTestCall(GenericAccessibleObject<?> call)
                 throws IllegalArgumentException

Add a test call

Throws:

IllegalArgumentException

removeTestCall

public void removeTestCall(GenericAccessibleObject<?> call)

addEnvironmentTestCall

public void addEnvironmentTestCall(GenericAccessibleObject<?> call)
                            throws IllegalArgumentException

Throws:

IllegalArgumentException

addCastClassForContainer

public void addCastClassForContainer(Class<?> clazz)

Add a new class observed at runtime for container methods

Parameters:

clazz -

clearGeneratorCache

public void clearGeneratorCache(GenericClass target)

Forget everything we have cached

Parameters:

target -

getAnalyzedClasses

@Deprecated
public Set<Class<?>> getAnalyzedClasses()

Deprecated.

Returns:

the analyzedClasses

getCallsFor

public Set<GenericAccessibleObject<?>> getCallsFor(GenericClass clazz,
                                                   boolean resolve)
                                            throws ConstructionFailedException

Return all calls that have a parameter with given type

Parameters:

clazz -

resolve -

Returns:

Throws:

ConstructionFailedException

getRandomCallFor

public GenericAccessibleObject<?> getRandomCallFor(GenericClass clazz,
                                                   TestCase test,
                                                   int position)
                                            throws ConstructionFailedException

Throws:

ConstructionFailedException

getClass

public Class<?> getClass(String name)
                  throws ClassNotFoundException

Find a class that matches the given name

Parameters:

name -

Returns:

Throws:

ClassNotFoundException

getGenerators

public Set<GenericAccessibleObject<?>> getGenerators()

Retrieve all generators

Returns:

getGenerators

public Set<GenericAccessibleObject<?>> getGenerators(GenericClass clazz,
                                                     boolean resolve)
                                              throws ConstructionFailedException

Get a list of all generator objects for the type

Parameters:

clazz -

resolve -

Returns:

Throws:

ConstructionFailedException

getKnownMatchingClasses

public Collection<Class<?>> getKnownMatchingClasses(String name)

Retrieve all classes that match the given postfix

Parameters:

name -

Returns:

getModifiers

public Set<GenericAccessibleObject<?>> getModifiers()

Retrieve all modifiers

Returns:

getObjectGenerators

public Set<GenericAccessibleObject<?>> getObjectGenerators()

Determine the set of generators for an Object.class instance

Returns:

a collection of all cast classes stored in CastClassManager; cannot be null>.

getRandomGenerator

public GenericAccessibleObject<?> getRandomGenerator(GenericClass clazz)
                                              throws ConstructionFailedException

Randomly select one generator

Parameters:

clazz -

Returns:

Throws:

ConstructionFailedException

getRandomGenerator

public GenericAccessibleObject<?> getRandomGenerator(GenericClass clazz,
                                                     Set<GenericAccessibleObject<?>> excluded,
                                                     TestCase test,
                                                     int position,
                                                     VariableReference generatorRefToExclude,
                                                     int recursionDepth)
                                              throws ConstructionFailedException

Randomly select one generator

Parameters:

clazz -

excluded -

test -

Returns:

null if there is no valid generator

Throws:

ConstructionFailedException

getRandomObjectGenerator

public GenericAccessibleObject<?> getRandomObjectGenerator()
                                                    throws ConstructionFailedException

Randomly select a generator for an Object.class instance

Returns:

a generator of type GenericAccessibleObject or null

Throws:

ConstructionFailedException

getRandomizedCallsToEnvironment

public List<GenericAccessibleObject<?>> getRandomizedCallsToEnvironment()

getNumOfEnvironmentCalls

public int getNumOfEnvironmentCalls()

getRandomTestCall

public GenericAccessibleObject<?> getRandomTestCall(TestCase test)
                                             throws ConstructionFailedException

Get random method or constructor of unit under test

Returns:

Throws:

ConstructionFailedException

getNumTestCalls

public int getNumTestCalls()

getTestCalls

public List<GenericAccessibleObject<?>> getTestCalls()

Get a list of all test calls (i.e., constructors and methods)

Returns:

Throws:

ConstructionFailedException

hasGenerator

public boolean hasGenerator(GenericClass clazz)

Determine if there are generators

Parameters:

clazz -

Returns:

hasGenerator

public boolean hasGenerator(Type type)

Determine if there are generators

Parameters:

type -

Returns:

importClass

public Class<?> importClass(String name)
                     throws ClassNotFoundException

Integrate a new class into the test cluster

Parameters:

name -

Throws:

ClassNotFoundException

toString

public String toString()

Overrides:

toString in class Object