de.rwth.swc.coffee4j.engine.manager

Class CachingDelegatingCombinatorialTestManager

java.lang.Object

de.rwth.swc.coffee4j.engine.manager.CachingDelegatingCombinatorialTestManager

All Implemented Interfaces:

CombinatorialTestManager

public class CachingDelegatingCombinatorialTestManager
extends Object
implements CombinatorialTestManager

A CombinatorialTestManager 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 and Description
CachingDelegatingCombinatorialTestManager(TestResultCache cache, CombinatorialTestManager generator)

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

CachingDelegatingCombinatorialTestManager

public CachingDelegatingCombinatorialTestManager(TestResultCache cache,
                                                 CombinatorialTestManager generator)

Method Detail

generateInitialTests

public List<int[]> generateInitialTests()

Description copied from interface: CombinatorialTestManager

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

Specified by:

generateInitialTests in interface CombinatorialTestManager

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: CombinatorialTestManager

Generates additional test inputs based on results of previous test inputs normally generated by either CombinatorialTestManager.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 CombinatorialTestManager

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