org.evosuite.testcase

Class TestFactory

java.lang.Object

org.evosuite.testcase.TestFactory

public class TestFactory
extends Object

Author:

Gordon Fraser

Method Summary

Modifier and Type	Method and Description
VariableReference	addConstructor(TestCase test, GenericConstructor constructor, int position, int recursionDepth)
VariableReference	addConstructor(TestCase test, GenericConstructor constructor, Type exactType, int position, int recursionDepth) Add constructor at given position if max recursion depth has not been reached
VariableReference	addField(TestCase test, GenericField field, int position, int recursionDepth) Add a field to the test case
VariableReference	addFieldAssignment(TestCase test, GenericField field, int position, int recursionDepth) Add method at given position if max recursion depth has not been reached
VariableReference	addFieldFor(TestCase test, VariableReference callee, GenericField field, int position) Add reference to a field of variable "callee"
VariableReference	addFunctionalMock(TestCase test, Type type, int position, int recursionDepth)
VariableReference	addMethod(TestCase test, GenericMethod method, int position, int recursionDepth) Add method at given position if max recursion depth has not been reached
VariableReference	addMethodFor(TestCase test, VariableReference callee, GenericMethod method, int position) Add a call on the method for the given callee at position
void	appendStatement(TestCase test, Statement statement) Append statement s, trying to satisfy parameters Called from TestChromosome when doing crossover
void	assignArray(TestCase test, VariableReference array, int arrayIndex, int position) Assign a value to an array index
protected void	assignArray(TestCase test, VariableReference array, int arrayIndex, int position, List<VariableReference> objects) Assign a value to an array index for a given set of objects
VariableReference	attemptGeneration(TestCase test, Type type, int position) Attempt to generate a non-null object; initialize recursion level to 0
protected VariableReference	attemptGeneration(TestCase test, Type type, int position, int recursionDepth, boolean allowNull, VariableReference generatorRefToExclude, boolean canUseMocks, boolean canReuseExistingVariables) Try to generate an object of a given type
protected VariableReference	attemptObjectGeneration(TestCase test, int position, int recursionDepth, boolean allowNull) Try to generate an object suitable for Object.class
void	changeCall(TestCase test, Statement statement, GenericAccessibleObject<?> call) Replace the statement with a new statement using given call
boolean	changeRandomCall(TestCase test, Statement statement)
VariableReference	createObject(TestCase test, Type type, int position, int recursionDepth, VariableReference generatorRefToExclude)
VariableReference	createObject(TestCase test, Type type, int position, int recursionDepth, VariableReference generatorRefToExclude, boolean allowNull, boolean canUseFunctionalMocks, boolean canReuseVariables) Create a new non-null, non-primitive object and return reference
boolean	deleteStatement(TestCase test, int position) Delete the statement at position from the test case and remove all references to it
boolean	deleteStatementGracefully(TestCase test, int position)
static TestFactory	getInstance()
boolean	insertRandomCall(TestCase test, int position) Insert a random call for the UUT at the given position
int	insertRandomCallOnEnvironment(TestCase test, int lastValidPosition)
boolean	insertRandomCallOnObjectAt(TestCase test, VariableReference var, int position)
int	insertRandomStatement(TestCase test, int lastPosition)
void	reset() We keep track of calls already attempted to avoid infinite recursion
List<VariableReference>	satisfyParameters(TestCase test, VariableReference callee, List<Type> parameterTypes, int position, int recursionDepth, boolean allowNull, boolean excludeCalleeGenerators, boolean canReuseExistingVariables) Satisfy a list of parameters by reusing or creating variables

Methods inherited from class java.lang.Object

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

Method Detail

reset

public void reset()

We keep track of calls already attempted to avoid infinite recursion

getInstance

public static TestFactory getInstance()

addFunctionalMock

public VariableReference addFunctionalMock(TestCase test,
                                           Type type,
                                           int position,
                                           int recursionDepth)
                                    throws ConstructionFailedException,
                                           IllegalArgumentException

Throws:

ConstructionFailedException

IllegalArgumentException

addConstructor

public VariableReference addConstructor(TestCase test,
                                        GenericConstructor constructor,
                                        int position,
                                        int recursionDepth)
                                 throws ConstructionFailedException

Throws:

ConstructionFailedException

addConstructor

public VariableReference addConstructor(TestCase test,
                                        GenericConstructor constructor,
                                        Type exactType,
                                        int position,
                                        int recursionDepth)
                                 throws ConstructionFailedException

Add constructor at given position if max recursion depth has not been reached

Parameters:

constructor -

position -

recursionDepth -

Returns:

Throws:

ConstructionFailedException

addField

public VariableReference addField(TestCase test,
                                  GenericField field,
                                  int position,
                                  int recursionDepth)
                           throws ConstructionFailedException

Add a field to the test case

Parameters:

test -

field -

position -

Returns:

Throws:

ConstructionFailedException

addFieldAssignment

public VariableReference addFieldAssignment(TestCase test,
                                            GenericField field,
                                            int position,
                                            int recursionDepth)
                                     throws ConstructionFailedException

Add method at given position if max recursion depth has not been reached

Parameters:

test -

field -

position -

recursionDepth -

Returns:

Throws:

ConstructionFailedException

addFieldFor

public VariableReference addFieldFor(TestCase test,
                                     VariableReference callee,
                                     GenericField field,
                                     int position)
                              throws ConstructionFailedException

Add reference to a field of variable "callee"

Parameters:

test -

callee -

field -

position -

Returns:

Throws:

ConstructionFailedException

addMethod

public VariableReference addMethod(TestCase test,
                                   GenericMethod method,
                                   int position,
                                   int recursionDepth)
                            throws ConstructionFailedException

Add method at given position if max recursion depth has not been reached

Parameters:

test -

method -

position -

recursionDepth -

Returns:

Throws:

ConstructionFailedException

addMethodFor

public VariableReference addMethodFor(TestCase test,
                                      VariableReference callee,
                                      GenericMethod method,
                                      int position)
                               throws ConstructionFailedException

Add a call on the method for the given callee at position

Parameters:

test -

callee -

method -

position -

Returns:

Throws:

ConstructionFailedException

appendStatement

public void appendStatement(TestCase test,
                            Statement statement)
                     throws ConstructionFailedException

Append statement s, trying to satisfy parameters Called from TestChromosome when doing crossover

Parameters:

test -

statement -

Throws:

ConstructionFailedException

assignArray

public void assignArray(TestCase test,
                        VariableReference array,
                        int arrayIndex,
                        int position)
                 throws ConstructionFailedException

Assign a value to an array index

Parameters:

test -

array -

arrayIndex -

position -

Throws:

ConstructionFailedException

assignArray

protected void assignArray(TestCase test,
                           VariableReference array,
                           int arrayIndex,
                           int position,
                           List<VariableReference> objects)
                    throws ConstructionFailedException

Assign a value to an array index for a given set of objects

Parameters:

test -

array -

arrayIndex -

position -

objects -

Throws:

ConstructionFailedException

attemptGeneration

public VariableReference attemptGeneration(TestCase test,
                                           Type type,
                                           int position)
                                    throws ConstructionFailedException

Attempt to generate a non-null object; initialize recursion level to 0

Throws:

ConstructionFailedException

attemptGeneration

protected VariableReference attemptGeneration(TestCase test,
                                              Type type,
                                              int position,
                                              int recursionDepth,
                                              boolean allowNull,
                                              VariableReference generatorRefToExclude,
                                              boolean canUseMocks,
                                              boolean canReuseExistingVariables)
                                       throws ConstructionFailedException

Try to generate an object of a given type

Parameters:

test -

type -

position -

recursionDepth -

allowNull -

Returns:

Throws:

ConstructionFailedException

attemptObjectGeneration

protected VariableReference attemptObjectGeneration(TestCase test,
                                                    int position,
                                                    int recursionDepth,
                                                    boolean allowNull)
                                             throws ConstructionFailedException

Try to generate an object suitable for Object.class

Parameters:

test -

position -

recursionDepth -

allowNull -

Returns:

Throws:

ConstructionFailedException

changeCall

public void changeCall(TestCase test,
                       Statement statement,
                       GenericAccessibleObject<?> call)
                throws ConstructionFailedException

Replace the statement with a new statement using given call

Parameters:

test -

statement -

call -

Throws:

ConstructionFailedException

changeRandomCall

public boolean changeRandomCall(TestCase test,
                                Statement statement)

createObject

public VariableReference createObject(TestCase test,
                                      Type type,
                                      int position,
                                      int recursionDepth,
                                      VariableReference generatorRefToExclude)
                               throws ConstructionFailedException

Throws:

ConstructionFailedException

createObject

public VariableReference createObject(TestCase test,
                                      Type type,
                                      int position,
                                      int recursionDepth,
                                      VariableReference generatorRefToExclude,
                                      boolean allowNull,
                                      boolean canUseFunctionalMocks,
                                      boolean canReuseVariables)
                               throws ConstructionFailedException

Create a new non-null, non-primitive object and return reference

Parameters:

test -

type -

position -

recursionDepth -

Returns:

Throws:

ConstructionFailedException

deleteStatement

public boolean deleteStatement(TestCase test,
                               int position)
                        throws ConstructionFailedException

Delete the statement at position from the test case and remove all references to it

Parameters:

test -

position -

Returns:

false if it was not possible to delete the statement

Throws:

ConstructionFailedException

deleteStatementGracefully

public boolean deleteStatementGracefully(TestCase test,
                                         int position)
                                  throws ConstructionFailedException

Parameters:

test -

position -

Returns:

true if statements was deleted or any dependency was modified

Throws:

ConstructionFailedException

insertRandomCallOnEnvironment

public int insertRandomCallOnEnvironment(TestCase test,
                                         int lastValidPosition)

Parameters:

test -

lastValidPosition -

Returns:

the position where the insertion happened, or a negative value otherwise

insertRandomCall

public boolean insertRandomCall(TestCase test,
                                int position)

Insert a random call for the UUT at the given position

Parameters:

test -

position -

insertRandomCallOnObjectAt

public boolean insertRandomCallOnObjectAt(TestCase test,
                                          VariableReference var,
                                          int position)

insertRandomStatement

public int insertRandomStatement(TestCase test,
                                 int lastPosition)

satisfyParameters

public List<VariableReference> satisfyParameters(TestCase test,
                                                 VariableReference callee,
                                                 List<Type> parameterTypes,
                                                 int position,
                                                 int recursionDepth,
                                                 boolean allowNull,
                                                 boolean excludeCalleeGenerators,
                                                 boolean canReuseExistingVariables)
                                          throws ConstructionFailedException

Satisfy a list of parameters by reusing or creating variables

Parameters:

test -

parameterTypes -

position -

recursionDepth -

Returns:

Throws:

ConstructionFailedException