edu.uta.cse.fireeye.common

Class TestSet

java.lang.Object

edu.uta.cse.fireeye.common.TestSet

public class TestSet
extends java.lang.Object

This class encodes a test set being generated. A test set contains a list of parameters and a matrix of values in which each row represents a test. The parameter values in a test set are represented internally as an integer. These values need to be converted back to user-friendly values before they are displayed to the user. Class TestSetWrapper provides a number of methods for this conversion.

Version:

1.0

Author:

Yu Lei

Field Summary

Fields

Modifier and Type	Field and Description
static int	DONT_CARE uninitialized value or values that do not affect the test
static java.lang.String	DONT_CARE_STRING string that indicates don't care values
static int	INVALID_VALUES_STARTINDEX
java.util.Map<java.lang.Integer,java.lang.Integer>	mapOfnumberOfCoveredCombos
int	numberOfCoveredCombos

Constructor Summary

Constructors

Constructor and Description
TestSet() Creates a new TestSet instance.
TestSet(java.util.ArrayList<Parameter> params) Creates a test set with a list of (input) parameters.
TestSet(java.util.ArrayList<Parameter> params, java.util.ArrayList<Parameter> outputParams) Creates a test set with a list of input parameters and a list of output parameters.

Method Summary

Modifier and Type	Method and Description
void	addMatrix(java.util.ArrayList<int[]> matrix) Adds an existing matrix into this test set.
void	addNewTest(int[] tuple)
void	addNewTest(edu.uta.cse.fireeye.service.engine.Tuple tuple) Add a new test to cover a given tuple.
void	addTest(int[] test) Adds a new test into this test set.
int[]	clone(int row) Makes a deep copy of a test (or row).
boolean	containsOutputParam(Parameter outputParam) Checks if a given output parameter is contained in this test set.
boolean	containsParam(Parameter param) Checks if a given (input) parameter is contained in this test set.
void	cover(int row, int[] tuple)
void	cover(int row, edu.uta.cse.fireeye.service.engine.Tuple tuple) Change an existing test to cover a tuple.
int	getColumnID(int paramID) Return the column ID of a given (input) parameter.
int	getExistingCols()
int	getExistingRows()
float	getGenerationTime() Gets the time taken to generate this test set.
java.util.ArrayList<int[]>	getMatrix() Gets the test matrix of this test set.
java.lang.Boolean	getNeedConstraintCheck(int row) get constraint check tag.
int	getNumOfParams() Gets the number of parameters in this test set.
int	getNumOfTests() Get the number of tests in this test set.
int	getOutputParamColumnID(int outputParamID) Returns the column ID of a given output parameter.
java.util.ArrayList<Parameter>	getOutputParams() Gets the list of output parameters.
Parameter	getParam(int index) Gets a parameter with a given index.
java.util.ArrayList<Parameter>	getParams() Get the parameters in this test set.
java.util.ArrayList<java.lang.Integer>	getStrikethroughRowIndices()
int[]	getTest(int row) Gets a test with a given row index in this test set.
int	getValue(int row, int column) Gets a value in this test set.
boolean	isCompatible(int[] row1, int[] row2) Checks whether two rows (tests) are compatible.
boolean	isCompatible(int row, edu.uta.cse.fireeye.service.engine.Tuple tuple) Checks whether a tuple can be covered by an existing test.
int[]	makeCompatibleTest(int row, int[] test, java.util.ArrayList<java.lang.Integer> changedCols)
void	setExistingCols(int existingCols)
void	setExistingRows(int existingRows)
void	setGenerationTime(float generationTime) Sets the time taken to generate this test set.
void	setMatrix(java.util.ArrayList<int[]> matrix) Sets the test matrix of this test set.
void	setNeedConstraintCheck(int row, java.lang.Boolean need)
void	setOutputParams(java.util.ArrayList<Parameter> outputParams) Sets the list of output parameters.
void	setParams(java.util.ArrayList<Parameter> params) Set the parameters for this test set.
void	setStrikethroughRowIndices(java.util.ArrayList<java.lang.Integer> strikethroughRowIndices)
void	setValue(int row, int column, int value) Sets a value in this test set.
java.lang.String	toString() Returns a string representation of this test set.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DONT_CARE

public static final int DONT_CARE

uninitialized value or values that do not affect the test

See Also:

Constant Field Values

DONT_CARE_STRING

public static final java.lang.String DONT_CARE_STRING

string that indicates don't care values

See Also:

Constant Field Values

INVALID_VALUES_STARTINDEX

public static final int INVALID_VALUES_STARTINDEX

See Also:

Constant Field Values

numberOfCoveredCombos

public int numberOfCoveredCombos

mapOfnumberOfCoveredCombos

public java.util.Map<java.lang.Integer,java.lang.Integer> mapOfnumberOfCoveredCombos

Constructor Detail

TestSet

public TestSet()

Creates a new TestSet instance.

TestSet

public TestSet(java.util.ArrayList<Parameter> params)

Creates a test set with a list of (input) parameters.

Parameters:

params - a list of parameters

TestSet

public TestSet(java.util.ArrayList<Parameter> params,
               java.util.ArrayList<Parameter> outputParams)

Creates a test set with a list of input parameters and a list of output parameters.

Parameters:

params - a list of input parameters

outputParams - a list of output parameters

Method Detail

getExistingRows

public int getExistingRows()

setExistingRows

public void setExistingRows(int existingRows)

getExistingCols

public int getExistingCols()

setExistingCols

public void setExistingCols(int existingCols)

setParams

public void setParams(java.util.ArrayList<Parameter> params)

Set the parameters for this test set.

Parameters:

params - a list of parameters

getParams

public java.util.ArrayList<Parameter> getParams()

Get the parameters in this test set.

Returns:

the list of parameters

getNumOfParams

public int getNumOfParams()

Gets the number of parameters in this test set.

Returns:

the number of parameters.

getParam

public Parameter getParam(int index)

Gets a parameter with a given index.

Parameters:

index - the parameter index

Returns:

the parameter

containsParam

public boolean containsParam(Parameter param)

Checks if a given (input) parameter is contained in this test set.

Parameters:

param - the given parameter

Returns:

true if the given parameter is contained in this test set, false otherwise.

containsOutputParam

public boolean containsOutputParam(Parameter outputParam)

Checks if a given output parameter is contained in this test set.

Parameters:

outputParam - the given parameter

Returns:

true if the given parameter is contained in this test set, false otherwise.

getColumnID

public int getColumnID(int paramID)

Return the column ID of a given (input) parameter. The column ID indicates which column this parameter is represented by in this test set.

Parameters:

paramID - the ID of the given parameter

Returns:

the column ID of the given parameter

getOutputParamColumnID

public int getOutputParamColumnID(int outputParamID)

Returns the column ID of a given output parameter. The column ID indicates which column this parameter is represented by in this test set.

Parameters:

outputParamID - the ID of the given parameter

Returns:

the column ID of the given parameter

addMatrix

public void addMatrix(java.util.ArrayList<int[]> matrix)

Adds an existing matrix into this test set. This matrix must be aligned with the list of parameters in this test set.

Parameters:

matrix - an existing test matrix

getMatrix

public java.util.ArrayList<int[]> getMatrix()

Gets the test matrix of this test set.

Returns:

the test matrix of this test set.

setMatrix

public void setMatrix(java.util.ArrayList<int[]> matrix)

Sets the test matrix of this test set.

Parameters:

matrix - the test matrix to be set

getTest

public int[] getTest(int row)

Gets a test with a given row index in this test set.

Parameters:

row - the row index

Returns:

getNumOfTests

public int getNumOfTests()

Get the number of tests in this test set.

Returns:

the number of tests.

getValue

public int getValue(int row,
                    int column)

Gets a value in this test set.

Parameters:

row - the row index

column - the column index

Returns:

the value

setValue

public void setValue(int row,
                     int column,
                     int value)

Sets a value in this test set.

Parameters:

row - the row index

column - the column index

value - the value to be set

isCompatible

public boolean isCompatible(int row,
                            edu.uta.cse.fireeye.service.engine.Tuple tuple)

Checks whether a tuple can be covered by an existing test.

Parameters:

row - the row index

tuple - the tuple

Returns:

true if the tuple can be covered

makeCompatibleTest

public int[] makeCompatibleTest(int row,
                                int[] test,
                                java.util.ArrayList<java.lang.Integer> changedCols)

isCompatible

public boolean isCompatible(int[] row1,
                            int[] row2)

Checks whether two rows (tests) are compatible. Two rows are compatible if they are of the same length, and if they can be converted to each other by changing DONT_CARE values only.

Parameters:

row1 - a row in this test set

row2 - a row in this test set

Returns:

true if the two rows are compatible

cover

public void cover(int row,
                  edu.uta.cse.fireeye.service.engine.Tuple tuple)

Change an existing test to cover a tuple.

Parameters:

row - the row index of the existing test

tuple - the tuple to be covered

cover

public void cover(int row,
                  int[] tuple)

addNewTest

public void addNewTest(edu.uta.cse.fireeye.service.engine.Tuple tuple)

Add a new test to cover a given tuple. All the remaining values are set to DONT_CARE values.

Parameters:

tuple - the tuple to be covered.

addNewTest

public void addNewTest(int[] tuple)

addTest

public void addTest(int[] test)

Adds a new test into this test set.

Parameters:

test -

getGenerationTime

public float getGenerationTime()

Gets the time taken to generate this test set.

Returns:

the time taken to generate this test set.

setGenerationTime

public void setGenerationTime(float generationTime)

Sets the time taken to generate this test set.

Parameters:

generationTime - the time taken to generat this test set.

clone

public int[] clone(int row)

Makes a deep copy of a test (or row).

Parameters:

row - the row index of the test to be copied.

Returns:

getOutputParams

public java.util.ArrayList<Parameter> getOutputParams()

Gets the list of output parameters.

Returns:

the list of output parameters

setOutputParams

public void setOutputParams(java.util.ArrayList<Parameter> outputParams)

Sets the list of output parameters.

Parameters:

outputParams - a list of output parameters

getNeedConstraintCheck

public java.lang.Boolean getNeedConstraintCheck(int row)

get constraint check tag. Used for constriant optimization.

Parameters:

row - number

setNeedConstraintCheck

public void setNeedConstraintCheck(int row,
                                   java.lang.Boolean need)

toString

public java.lang.String toString()

Returns a string representation of this test set.

Overrides:

toString in class java.lang.Object

getStrikethroughRowIndices

public java.util.ArrayList<java.lang.Integer> getStrikethroughRowIndices()

setStrikethroughRowIndices

public void setStrikethroughRowIndices(java.util.ArrayList<java.lang.Integer> strikethroughRowIndices)