org.evosuite.testcase

Class TestChromosome

java.lang.Object

org.evosuite.ga.Chromosome

org.evosuite.testcase.ExecutableChromosome

org.evosuite.testcase.TestChromosome

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Chromosome>, PublicCloneable<Chromosome>

Direct Known Subclasses:

RegressionTestChromosome

public class TestChromosome
extends ExecutableChromosome

Chromosome representation of test cases

Author:

Gordon Fraser

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected MutationHistory<TestMutationHistoryEntry>	mutationHistory To keep track of what has changed since last fitness evaluation
protected TestCase	test The test case encoded in this chromosome

Fields inherited from class org.evosuite.testcase.ExecutableChromosome

lastExecutionResult, lastMutationResult

Fields inherited from class org.evosuite.ga.Chromosome

age, distance, rank, toBeUpdated

Constructor Summary

Constructors

Constructor and Description
TestChromosome()

Method Summary

Modifier and Type	Method and Description
static void	addSecondaryObjective(SecondaryObjective<?> objective) Add an additional secondary objective to the end of the list of objectives
void	clearMutationHistory()
Chromosome	clone() clone
<T extends Chromosome> int	compareSecondaryObjective(T o) Secondary Objectives are specific to chromosome types
int	compareTo(Chromosome o) Determine relative ordering of this chromosome to another chromosome.
void	copyCachedResults(ExecutableChromosome other) copyCachedResults
void	crossOver(Chromosome other, int position1, int position2) Single point cross over
protected boolean	deleteStatement(TestFactory testFactory, int num)
boolean	equals(Object obj) Two chromosomes are equal if their tests are equal
ExecutionResult	executeForFitnessFunction(TestSuiteFitnessFunction testSuiteFitnessFunction) executeForFitnessFunction
MutationHistory<TestMutationHistoryEntry>	getMutationHistory()
static List<SecondaryObjective<?>>	getSecondaryObjectives() Getter for the field secondaryObjectives.
TestCase	getTestCase() getTestCase
boolean	hasException() hasException
int	hashCode()
boolean	hasRelevantMutations()
boolean	localSearch(LocalSearchObjective<? extends Chromosome> objective) Apply the local search
void	mutate() Apply mutation
boolean	mutationInsert() With exponentially decreasing probability, insert statements at random position
static void	removeSecondaryObjective(SecondaryObjective<?> objective) Remove secondary objective from list, if it is there
static void	reverseSecondaryObjective()
void	setChanged(boolean changed) Set changed status to @param changed
void	setLastExecutionResult(ExecutionResult lastExecutionResult) Setter for the field lastExecutionResult.
void	setTestCase(TestCase testCase) setTestCase
static void	ShuffleSecondaryObjective()
int	size() Return length of individual
String	toString()

Methods inherited from class org.evosuite.testcase.ExecutableChromosome

clearCachedMutationResults, clearCachedResults, getLastExecutionResult, getLastExecutionResult, setLastExecutionResult

Methods inherited from class org.evosuite.ga.Chromosome

addFitness, addFitness, addFitness, addFitness, crossOver, getAge, getCoverage, getCoverage, getCoverageInstanceOf, getCoverageValues, getDistance, getFitness, getFitness, getFitnessInstanceOf, getFitnessValues, getNumOfCoveredGoals, getNumOfCoveredGoals, getNumOfNotCoveredGoals, getNumOfNotCoveredGoals, getNumsNotCoveredGoals, getNumsOfCoveredGoals, getPreviousFitnessValues, getRank, hasExecutedFitness, hasFitnessChanged, hasLocalSearchBeenApplied, isChanged, isToBeUpdated, isToBeUpdated, setCoverage, setCoverageValues, setDistance, setFitness, setFitnessValues, setLocalSearchApplied, setNumOfCoveredGoals, setNumOfNotCoveredGoals, setNumsOfCoveredGoals, setNumsOfNotCoveredGoals, setPreviousFitnessValues, setRank, updateAge

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

test

protected TestCase test

The test case encoded in this chromosome

mutationHistory

protected MutationHistory<TestMutationHistoryEntry> mutationHistory

To keep track of what has changed since last fitness evaluation

Constructor Detail

TestChromosome

public TestChromosome()

Method Detail

setTestCase

public void setTestCase(TestCase testCase)

setTestCase

Parameters:

testCase - a TestCase object.

getTestCase

public TestCase getTestCase()

getTestCase

Returns:

a TestCase object.

setLastExecutionResult

public void setLastExecutionResult(ExecutionResult lastExecutionResult)

Setter for the field lastExecutionResult.

Overrides:

setLastExecutionResult in class ExecutableChromosome

Parameters:

lastExecutionResult - a ExecutionResult object.

setChanged

public void setChanged(boolean changed)

Set changed status to @param changed

Overrides:

setChanged in class Chromosome

Parameters:

changed - a boolean.

clone

public Chromosome clone()

clone

Create a deep copy of the chromosome Create a deep copy of the chromosome

Specified by:

clone in interface PublicCloneable<Chromosome>

Specified by:

clone in class Chromosome

Returns:

a T object.

copyCachedResults

public void copyCachedResults(ExecutableChromosome other)

copyCachedResults

Specified by:

copyCachedResults in class ExecutableChromosome

Parameters:

other - a ExecutableChromosome object.

crossOver

public void crossOver(Chromosome other,
                      int position1,
                      int position2)
               throws ConstructionFailedException

Single point cross over Single point cross over

Specified by:

crossOver in class Chromosome

Parameters:

other - a Chromosome object.

position1 - a int.

position2 - a int.

Throws:

ConstructionFailedException - if any.

equals

public boolean equals(Object obj)

Two chromosomes are equal if their tests are equal

Specified by:

equals in class Chromosome

hashCode

public int hashCode()

Specified by:

hashCode in class Chromosome

getMutationHistory

public MutationHistory<TestMutationHistoryEntry> getMutationHistory()

clearMutationHistory

public void clearMutationHistory()

hasRelevantMutations

public boolean hasRelevantMutations()

localSearch

public boolean localSearch(LocalSearchObjective<? extends Chromosome> objective)

Apply the local search

Specified by:

localSearch in class Chromosome

Parameters:

objective - a LocalSearchObjective object.

mutate

public void mutate()

Apply mutation Each statement is mutated with probability 1/l

Specified by:

mutate in class Chromosome

deleteStatement

protected boolean deleteStatement(TestFactory testFactory,
                                  int num)

mutationInsert

public boolean mutationInsert()

With exponentially decreasing probability, insert statements at random position

Returns:

size

public int size()

Return length of individual The size of a chromosome is the length of its test case

Specified by:

size in class Chromosome

Returns:

a int.

compareTo

public int compareTo(Chromosome o)

Determine relative ordering of this chromosome to another chromosome. If the fitness values are equal, go through all secondary objectives and try to find one where the two are not equal.

Specified by:

compareTo in interface Comparable<Chromosome>

Overrides:

compareTo in class Chromosome

toString

public String toString()

Overrides:

toString in class Object

hasException

public boolean hasException()

hasException

Returns:

a boolean.

executeForFitnessFunction

public ExecutionResult executeForFitnessFunction(TestSuiteFitnessFunction testSuiteFitnessFunction)

executeForFitnessFunction

Specified by:

executeForFitnessFunction in class ExecutableChromosome

Parameters:

testSuiteFitnessFunction - a TestSuiteFitnessFunction object.

Returns:

a ExecutionResult object.

compareSecondaryObjective

public <T extends Chromosome> int compareSecondaryObjective(T o)

Description copied from class: Chromosome

Secondary Objectives are specific to chromosome types

Specified by:

compareSecondaryObjective in class Chromosome

Parameters:

o - a Chromosome object.

Returns:

a int.

addSecondaryObjective

public static void addSecondaryObjective(SecondaryObjective<?> objective)

Add an additional secondary objective to the end of the list of objectives

Parameters:

objective - a SecondaryObjective object.

ShuffleSecondaryObjective

public static void ShuffleSecondaryObjective()

reverseSecondaryObjective

public static void reverseSecondaryObjective()

removeSecondaryObjective

public static void removeSecondaryObjective(SecondaryObjective<?> objective)

Remove secondary objective from list, if it is there

Parameters:

objective - a SecondaryObjective object.

getSecondaryObjectives

public static List<SecondaryObjective<?>> getSecondaryObjectives()

Getter for the field secondaryObjectives.

Returns:

a List object.