Package de.rwth.swc.coffee4j.algorithmic.sequential.manager

Class CachingDelegatingSequentialCombinatorialTestManager

java.lang.Object

de.rwth.swc.coffee4j.algorithmic.sequential.manager.CachingDelegatingSequentialCombinatorialTestManager

All Implemented Interfaces:

SequentialCombinatorialTestManager

public class CachingDelegatingSequentialCombinatorialTestManager
extends Object
implements SequentialCombinatorialTestManager

A SequentialCombinatorialTestManager which does not generate test inputs by itself but delegates this to another manager. However, it does add caching capability to any given manager. This means no test input is returned twice across all two methods. For example, if the initial test input [0, 0, 0] has been returned, it will not be returned again for fault characterization. Instead the cached result is used. With an appropriate cache, results can even be shared over multiple runs if that should ever be desirable.

Constructor Summary

Constructors

Constructor	Description
CachingDelegatingSequentialCombinatorialTestManager(TestResultCache cache, SequentialCombinatorialTestManager generator)

Method Summary

Modifier and Type	Method	Description
List<int[]>	generateAdditionalTestInputsWithResult(int[] testInput, TestResult testResult)	Generates additional test inputs based on results of previous test inputs normally generated by either SequentialCombinatorialTestManager.generateInitialTests() or this method in a previous iteration.
List<int[]>	generateInitialTests()	Generates all initial test inputs for execution.
SequentialCombinatorialTestManager	getGenerator()

Methods inherited from class java.lang.Object

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

Constructor Detail

CachingDelegatingSequentialCombinatorialTestManager

public CachingDelegatingSequentialCombinatorialTestManager(TestResultCache cache,
                                                           SequentialCombinatorialTestManager generator)

Method Detail

generateInitialTests

public List<int[]> generateInitialTests()

Description copied from interface: SequentialCombinatorialTestManager

Generates all initial test inputs for execution. This should generate at least one test input if dynamic generation via SequentialCombinatorialTestManager.generateAdditionalTestInputsWithResult(int[], TestResult) should be used, as most front-ends won't call SequentialCombinatorialTestManager.generateAdditionalTestInputsWithResult(int[], TestResult) if this returned no test input.

Specified by:

generateInitialTests in interface SequentialCombinatorialTestManager

Returns:

a list of all initial test inputs. It is not guaranteed that these test inputs don't contain duplicates

generateAdditionalTestInputsWithResult

public List<int[]> generateAdditionalTestInputsWithResult(int[] testInput,
                                                          TestResult testResult)

Description copied from interface: SequentialCombinatorialTestManager

Generates additional test inputs based on results of previous test inputs normally generated by either SequentialCombinatorialTestManager.generateInitialTests() or this method in a previous iteration. For example, this functionality can be used to implement dynamic test input generation or fault characterization (or a combination of both).

Specified by:

generateAdditionalTestInputsWithResult in interface SequentialCombinatorialTestManager

Parameters:

testInput - the test input for which's result further test inputs should be generated

testResult - the result of the test input

Returns:

a list of additional test inputs generated based on the result of the given test inputs. This does not necessarily have to return any test inputs for each call

getGenerator

public SequentialCombinatorialTestManager getGenerator()