com.sun.javatest
Class BasicParameters

java.lang.Object
  extended by com.sun.javatest.BasicParameters
All Implemented Interfaces:
Parameters, Parameters.ConcurrencyParameters, Parameters.ExcludeListParameters, Parameters.KeywordsParameters, Parameters.MutableConcurrencyParameters, Parameters.MutableExcludeListParameters, Parameters.MutableKeywordsParameters, Parameters.MutablePriorStatusParameters, Parameters.MutableTestsParameters, Parameters.MutableTimeoutFactorParameters, Parameters.PriorStatusParameters, Parameters.TestsParameters, Parameters.TimeoutFactorParameters
Direct Known Subclasses:
FileParameters

public abstract class BasicParameters
extends java.lang.Object
implements Parameters, Parameters.MutableTestsParameters, Parameters.MutableExcludeListParameters, Parameters.MutableKeywordsParameters, Parameters.MutablePriorStatusParameters, Parameters.MutableConcurrencyParameters, Parameters.MutableTimeoutFactorParameters

A basic implementation of Parameters for all except the EnvParameters subsection.


Nested Class Summary
 
Nested classes/interfaces inherited from interface com.sun.javatest.Parameters
Parameters.ConcurrencyParameters, Parameters.EnvParameters, Parameters.ExcludeListParameters, Parameters.KeywordsParameters, Parameters.LegacyEnvParameters, Parameters.MutableConcurrencyParameters, Parameters.MutableExcludeListParameters, Parameters.MutableKeywordsParameters, Parameters.MutablePriorStatusParameters, Parameters.MutableTestsParameters, Parameters.MutableTimeoutFactorParameters, Parameters.PriorStatusParameters, Parameters.TestsParameters, Parameters.TimeoutFactorParameters
 
Field Summary
protected  java.lang.String concurrencyError
          A string to identify any errors that may have occurred when setting the concurrency, or null if there were no such errors.
protected  java.lang.String excludeListError
          A string to identify any errors that may have occurred when setting the exclude list parameters, or null if there were no such errors.
protected  java.lang.String keywordsError
          A string to identify any errors that may have occurred when setting the keywords parameters, or null if there were no such errors.
protected  java.lang.String testSuiteError
          A string to identify any errors that may have occurred when setting the test suite, or null if there were no such errors.
protected  java.lang.String timeoutFactorError
          A string to identify any errors that may have occurred when setting the timeout factor, or null if there were no such errors.
protected  java.lang.String workDirError
          A string to identify any errors that may have occurred when setting the work directory, or null if there were no such errors.
 
Fields inherited from interface com.sun.javatest.Parameters.MutableTestsParameters
ALL_TESTS, SPECIFIED_TESTS
 
Fields inherited from interface com.sun.javatest.Parameters.MutableExcludeListParameters
CHECK_EVERY_RUN, CHECK_EVERY_X_DAYS, CUSTOM_EXCLUDE_LIST, INITIAL_EXCLUDE_LIST, LATEST_EXCLUDE_LIST, NO_EXCLUDE_LIST
 
Fields inherited from interface com.sun.javatest.Parameters.MutableKeywordsParameters
ALL_OF, ANY_OF, EXPR, MATCH_KEYWORDS, NO_KEYWORDS
 
Fields inherited from interface com.sun.javatest.Parameters.MutablePriorStatusParameters
MATCH_PRIOR_STATUS, NO_PRIOR_STATUS
 
Fields inherited from interface com.sun.javatest.Parameters.ConcurrencyParameters
MAX_CONCURRENCY, MIN_CONCURRENCY
 
Fields inherited from interface com.sun.javatest.Parameters.TimeoutFactorParameters
MAX_TIMEOUT_FACTOR, MIN_TIMEOUT_FACTOR
 
Constructor Summary
BasicParameters()
           
 
Method Summary
protected static boolean equal(boolean[] b1, boolean[] b2)
          Compare two boolean arrays for equality.
protected static boolean equal(java.io.File[] f1, java.io.File[] f2)
          Compare two arrays of Files for equality.
protected static java.io.File[] getAbsoluteFiles(java.io.File baseDir, java.io.File[] files)
          Convert a set of files to be absolute files.
 int getConcurrency()
          Get an integer specifying the maximum number of tests that may be run in parallel.
 Parameters.ConcurrencyParameters getConcurrencyParameters()
          Get an object which provides access to the integer specifying the maximum number of tests that may be run in parallel.
 java.io.File[] getCustomExcludeFiles()
          Get the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.
 java.lang.String getErrorMessage()
          If there is an error in any of the configuration values, as indicated by isValid, this method will provide a detail message about one or more of the invalid values.
 java.io.File[] getExcludeFiles()
          Get the set of files which define the exclude list.
 ExcludeList getExcludeList()
          Get an exclude list which identifies tests or test cases to be excluded from the test run.
 TestFilter getExcludeListFilter()
          Get a filter which will filter tests according to the result of getExcludeList().
 Parameters.ExcludeListParameters getExcludeListParameters()
          Get an object which provides access to the exclude list which identifies tests or test cases to be excluded from the test run.
 int getExcludeMode()
          Get the current exclude list mode.
 TestFilter[] getFilters()
          Get an array of the non-null filters returned from getExcludeListFilter, getKeywordsFilter, getPriorStatusFilter, and getRelevantTestFilter.
 Keywords getKeywords()
          Get a keywords object which identifies tests to be run according to their keywords.
 TestFilter getKeywordsFilter()
          Get a filter which will filter tests according to the result of getKeywords().
 int getKeywordsMode()
          Get the current keywords mode.
 Parameters.KeywordsParameters getKeywordsParameters()
          Get an object which provides access to the keywords object which identifies tests to be run according to their keywords.
 int getLatestExcludeAutoCheckInterval()
          Get the interval, in days, to be used when automatically checking for exclude list updates and the auto check mode is set to CHECK_EVERY_X_DAYS.
 int getLatestExcludeAutoCheckMode()
          Get the mode which defines how often to automatically check for updated exclude lists, when the exclude list mode is set to LATEST_EXCLUDE_LIST, and the automatic check is enabled.
 int getMatchKeywordsMode()
          Get a value which indicates how to interpret the match value, when the keywords mode is set to MATCH_KEYWORDS.
 java.lang.String getMatchKeywordsValue()
          Get a value that identifies which tests are to be selected, when the keywords mode is set to MATCH_KEYWORDS.
 boolean[] getMatchPriorStatusValues()
          Get an array of booleans which identify which tests to be run, according to their prior execution status.
 TestFilter getPriorStatusFilter()
          Get a filter which will filter tests according to the result of getPriorStatusValus().
 int getPriorStatusMode()
          Get the current mode determining whether tests are selected or not according to their prior execution status.
 Parameters.PriorStatusParameters getPriorStatusParameters()
          Get an object which provides access to an array of booleans which identify tests to be run according to their prior execution status.
 boolean[] getPriorStatusValues()
          Get an array of booleans which identify tests to be run according to their prior execution status.
 TestFilter getRelevantTestFilter()
          Get a test-suite specific filter which will filter tests according to test-suite-specific criteria, as perhaps determined by a configuration interview.
 java.lang.String[] getSpecifiedTests()
          Get the set of specified tests to be used as the set of tests to be run when the mode is set to SPECIFIED_TESTS.
 java.lang.String[] getTests()
          Get the paths identifying the tests or folders of tests within the test suite to be run.
 int getTestsMode()
          Get the current mode for how the tests are specified.
 Parameters.TestsParameters getTestsParameters()
          Get an object which provides access to the paths identifying the tests or folders of tests to be run.
 TestSuite getTestSuite()
          Get the test suite for which these parameters apply.
 float getTimeoutFactor()
          Get an integer specifying a scale factor to be applied to the standard timeout for the test.
 Parameters.TimeoutFactorParameters getTimeoutFactorParameters()
          Get an object which provides access to the integer specifying a scale factor to be applied to the standard timeout for the test.
 WorkDirectory getWorkDirectory()
          Get the work directory in which to store the results of the test run.
 boolean isLatestExcludeAutoCheckEnabled()
          Check if the automatic check for newer exclude lists is enabled when the exclude list mode is set to LATEST_EXCLUDE_LIST.
 boolean isValid()
          Determine whether all the configuration values are valid.
 void setConcurrency(int conc)
          Set an integer specifying the maximum number of tests that may be run in parallel.
 void setCustomExcludeFiles(java.io.File[] files)
          Set the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.
 void setExcludeFiles(java.io.File[] files)
          Set the set of files used to define the exclude list.
 void setExcludeMode(int mode)
          Set the current exclude list mode.
 void setKeywords(int mode, java.lang.String value)
          Set the details of the keywords to be used, if any, to filter tests for execution.
 void setKeywordsMode(int mode)
          Set the current keywords mode.
 void setLatestExcludeAutoCheckEnabled(boolean b)
          Specify if the automatic check for newer exclude lists is enabled when the exclude list mode is set to LATEST_EXCLUDE_LIST.
 void setLatestExcludeAutoCheckInterval(int days)
          Set the interval, in days, to be used when automatically checking for exclude list updates and the auto check mode is set to CHECK_EVERY_X_DAYS.
 void setLatestExcludeAutoCheckMode(int mode)
          Set the mode which defines how often to automatically check for updated exclude lists, when the exclude list mode is set to LATEST_EXCLUDE_LIST, and the automatic check is enabled.
 void setMatchKeywords(int mode, java.lang.String value)
          Set how to match a tests keywords when the keywords mode is set to MATCH_KEYWORDS.
 void setMatchPriorStatusValues(boolean[] v)
          Set an array of booleans to identify which tests to be run, according to their prior execution status.
 void setPriorStatusMode(int mode)
          Set the current mode determining whether tests are selected or not according to their prior execution status.
 void setPriorStatusValues(boolean[] values)
          Set which prior status values should be used, if any, to select tests for execution.
 void setSpecifiedTests(java.lang.String[] tests)
          Set the specified tests to be be run when the mode is set to SPECIFIED_TESTS.
 void setTests(java.lang.String[] tests)
          Specify the tests to be executed.
 void setTestsMode(int mode)
          Set the current mode for how the tests are specified.
 void setTestSuite(java.io.File file)
          Set the test suite for the test run.
 void setTestSuite(TestSuite ts)
          Set the test suite for the test run.
 void setTimeoutFactor(float tf)
          Set an integer specifying a scale factor to be applied to the standard timeout for the test.
 void setWorkDirectory(java.io.File dir)
          Set the work directory for the test run.
 void setWorkDirectory(WorkDirectory wd)
          Set the work directory for the test run.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.sun.javatest.Parameters
getEnv, getEnvParameters
 

Field Detail

testSuiteError

protected java.lang.String testSuiteError
A string to identify any errors that may have occurred when setting the test suite, or null if there were no such errors.


workDirError

protected java.lang.String workDirError
A string to identify any errors that may have occurred when setting the work directory, or null if there were no such errors.


excludeListError

protected java.lang.String excludeListError
A string to identify any errors that may have occurred when setting the exclude list parameters, or null if there were no such errors.


keywordsError

protected java.lang.String keywordsError
A string to identify any errors that may have occurred when setting the keywords parameters, or null if there were no such errors.


concurrencyError

protected java.lang.String concurrencyError
A string to identify any errors that may have occurred when setting the concurrency, or null if there were no such errors.


timeoutFactorError

protected java.lang.String timeoutFactorError
A string to identify any errors that may have occurred when setting the timeout factor, or null if there were no such errors.

Constructor Detail

BasicParameters

public BasicParameters()
Method Detail

getTestSuite

public TestSuite getTestSuite()
Description copied from interface: Parameters
Get the test suite for which these parameters apply.

Specified by:
getTestSuite in interface Parameters
Returns:
the test suite for which these parameters apply.
See Also:
Parameters.setTestSuite(com.sun.javatest.TestSuite)

setTestSuite

public void setTestSuite(java.io.File file)
Set the test suite for the test run. The test suite may only be set once. If the test suite cannot be opened, isValid will return false, and getErrorMessage will contain an error message.

Parameters:
file - a path defining the test suite to be opened and set as the test suite for the test run.
See Also:
getTestSuite(), setTestSuite(TestSuite)

setTestSuite

public void setTestSuite(TestSuite ts)
Set the test suite for the test run. The test suite may only be set once.

Specified by:
setTestSuite in interface Parameters
Parameters:
ts - the test suite to be set.
Throws:
java.lang.NullPointerException - if ts is null
java.lang.IllegalStateException - if the test suite has already been set to something different
See Also:
getTestSuite()

getWorkDirectory

public WorkDirectory getWorkDirectory()
Description copied from interface: Parameters
Get the work directory in which to store the results of the test run.

Specified by:
getWorkDirectory in interface Parameters
Returns:
the work directory in which to store the results of the test run.
See Also:
Parameters.setWorkDirectory(com.sun.javatest.WorkDirectory)

setWorkDirectory

public void setWorkDirectory(java.io.File dir)
Set the work directory for the test run. The work directory may only be set once. If the work directory cannot be opened, isValid will return false, and getErrorMessage will contain an error message. The test suite must already be set before this method is called.

Parameters:
dir - a path defining the work directory to be opened and set as the work directory for the test run.
See Also:
getWorkDirectory(), setWorkDirectory(WorkDirectory)

setWorkDirectory

public void setWorkDirectory(WorkDirectory wd)
Set the work directory for the test run. The work directory may only be set once. If the test suite has already been set, it must exactly match the test suite for the work directory; if the test suite has not yet been set, it will be set to the test suite for this work directory.

Specified by:
setWorkDirectory in interface Parameters
Parameters:
wd - the work directory to be set.
Throws:
java.lang.NullPointerException - if wd is null
java.lang.IllegalStateException - if the work directory has already been set to something different
See Also:
getWorkDirectory()

getTestsParameters

public Parameters.TestsParameters getTestsParameters()
Description copied from interface: Parameters
Get an object which provides access to the paths identifying the tests or folders of tests to be run.

Specified by:
getTestsParameters in interface Parameters
Returns:
an object which provides access to the paths identifying tests to be run.

getTests

public java.lang.String[] getTests()
Description copied from interface: Parameters
Get the paths identifying the tests or folders of tests within the test suite to be run.

Specified by:
getTests in interface Parameters
Specified by:
getTests in interface Parameters.TestsParameters
Returns:
an array of paths identifying the tests to be run
See Also:
Parameters.TestsParameters.getTests()

setTests

public void setTests(java.lang.String[] tests)
Description copied from interface: Parameters.MutableTestsParameters
Specify the tests to be executed.

Specified by:
setTests in interface Parameters.MutableTestsParameters
Parameters:
tests - If null, set the tests mode to ALL_TESTS; if not null, set the tests mode to SPECIFIED_TESTS, and set the specified tests.
See Also:
Parameters.TestsParameters.getTests()

getTestsMode

public int getTestsMode()
Description copied from interface: Parameters.MutableTestsParameters
Get the current mode for how the tests are specified.

Specified by:
getTestsMode in interface Parameters.MutableTestsParameters
Returns:
ALL_TESTS if all tests are to be run, irrespective of the selected tests, or SPECIFIED_TESTS if a set of specified tests are to be run.
See Also:
Parameters.MutableTestsParameters.setTestsMode(int), Parameters.MutableTestsParameters.ALL_TESTS, Parameters.MutableTestsParameters.SPECIFIED_TESTS

setTestsMode

public void setTestsMode(int mode)
Description copied from interface: Parameters.MutableTestsParameters
Set the current mode for how the tests are specified.

Specified by:
setTestsMode in interface Parameters.MutableTestsParameters
Parameters:
mode - use ALL_TESTS if all tests are to be run, irrespective of the selected tests, or SPECIFIED_TESTS if a set of specified tests are to be run.
See Also:
Parameters.MutableTestsParameters.getTestsMode(), Parameters.MutableTestsParameters.ALL_TESTS, Parameters.MutableTestsParameters.SPECIFIED_TESTS

getSpecifiedTests

public java.lang.String[] getSpecifiedTests()
Description copied from interface: Parameters.MutableTestsParameters
Get the set of specified tests to be used as the set of tests to be run when the mode is set to SPECIFIED_TESTS. When the mode is set to ALL_TESTS, the specified tests are remembered, but not used, until the mode is set back to SPECIFIED_TESTS.

Specified by:
getSpecifiedTests in interface Parameters.MutableTestsParameters
Returns:
an array of specified tests to be used as the set of tests to be run when the mode is set to SPECIFIED_TESTS.
See Also:
Parameters.MutableTestsParameters.setSpecifiedTests(java.lang.String[]), Parameters.TestsParameters.getTests()

setSpecifiedTests

public void setSpecifiedTests(java.lang.String[] tests)
Description copied from interface: Parameters.MutableTestsParameters
Set the specified tests to be be run when the mode is set to SPECIFIED_TESTS. When the mode is set to ALL_TESTS, these tests are remembered, but not used, until the mode is set back to SPECIFIED_TESTS.

Specified by:
setSpecifiedTests in interface Parameters.MutableTestsParameters
Parameters:
tests - an array of paths identifying the tests to be run
See Also:
Parameters.MutableTestsParameters.getSpecifiedTests(), Parameters.TestsParameters.getTests()

getExcludeListParameters

public Parameters.ExcludeListParameters getExcludeListParameters()
Description copied from interface: Parameters
Get an object which provides access to the exclude list which identifies tests or test cases to be excluded from the test run.

Specified by:
getExcludeListParameters in interface Parameters
Returns:
an object which provides access to the exclude list identifying tests or test cases to be excluded from the test run.

getExcludeFiles

public java.io.File[] getExcludeFiles()
Description copied from interface: Parameters.MutableExcludeListParameters
Get the set of files which define the exclude list. The files are all returned as absolute files.

Specified by:
getExcludeFiles in interface Parameters.MutableExcludeListParameters
Returns:
the set of files which define the exclude list
See Also:
Parameters.MutableExcludeListParameters.getExcludeFiles(), Parameters.MutableExcludeListParameters.setExcludeFiles(java.io.File[])

setExcludeFiles

public void setExcludeFiles(java.io.File[] files)
Description copied from interface: Parameters.MutableExcludeListParameters
Set the set of files used to define the exclude list.

Specified by:
setExcludeFiles in interface Parameters.MutableExcludeListParameters
Parameters:
files - If null, the exclude mode will be set to NO_EXCLUDE_LIST; if not null, the exclude mode will be set to CUSTOM_EXCLUDE_LIST and the custom exclude files will be set to this value
See Also:
Parameters.MutableExcludeListParameters.getExcludeFiles()

getExcludeList

public ExcludeList getExcludeList()
Description copied from interface: Parameters
Get an exclude list which identifies tests or test cases to be excluded from the test run.

Specified by:
getExcludeList in interface Parameters
Specified by:
getExcludeList in interface Parameters.ExcludeListParameters
Returns:
an exclude list identifying tests or test cases to be excluded from the test run.
See Also:
Parameters.getExcludeListFilter(), Parameters.ExcludeListParameters.getExcludeList()

getExcludeListFilter

public TestFilter getExcludeListFilter()
Description copied from interface: Parameters
Get a filter which will filter tests according to the result of getExcludeList(). If the result of getExcludeList is null or an empty exclude list, the result of this method will also be null.

Specified by:
getExcludeListFilter in interface Parameters
Returns:
a filter which will filter tests according to the result of getExcludeList().
See Also:
Parameters.getExcludeList()

getExcludeMode

public int getExcludeMode()
Description copied from interface: Parameters.MutableExcludeListParameters
Get the current exclude list mode.

Specified by:
getExcludeMode in interface Parameters.MutableExcludeListParameters
Returns:
A value indicating the current exclude list mode
See Also:
Parameters.MutableExcludeListParameters.setExcludeMode(int), Parameters.MutableExcludeListParameters.NO_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.INITIAL_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.LATEST_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.CUSTOM_EXCLUDE_LIST

setExcludeMode

public void setExcludeMode(int mode)
Description copied from interface: Parameters.MutableExcludeListParameters
Set the current exclude list mode.

Specified by:
setExcludeMode in interface Parameters.MutableExcludeListParameters
Parameters:
mode - A value indicating the desired exclude list mode
See Also:
Parameters.MutableExcludeListParameters.getExcludeMode(), Parameters.MutableExcludeListParameters.NO_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.INITIAL_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.LATEST_EXCLUDE_LIST, Parameters.MutableExcludeListParameters.CUSTOM_EXCLUDE_LIST

getCustomExcludeFiles

public java.io.File[] getCustomExcludeFiles()
Description copied from interface: Parameters.MutableExcludeListParameters
Get the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.

Specified by:
getCustomExcludeFiles in interface Parameters.MutableExcludeListParameters
Returns:
the files used to define a custom exclude list
See Also:
Parameters.MutableExcludeListParameters.setCustomExcludeFiles(java.io.File[])

setCustomExcludeFiles

public void setCustomExcludeFiles(java.io.File[] files)
Description copied from interface: Parameters.MutableExcludeListParameters
Set the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.

Specified by:
setCustomExcludeFiles in interface Parameters.MutableExcludeListParameters
Parameters:
files - the files used to define a custom exclude list
See Also:
Parameters.MutableExcludeListParameters.getCustomExcludeFiles()

isLatestExcludeAutoCheckEnabled

public boolean isLatestExcludeAutoCheckEnabled()
Description copied from interface: Parameters.MutableExcludeListParameters
Check if the automatic check for newer exclude lists is enabled when the exclude list mode is set to LATEST_EXCLUDE_LIST.

Specified by:
isLatestExcludeAutoCheckEnabled in interface Parameters.MutableExcludeListParameters
Returns:
true if the automatic check is enabled
See Also:
Parameters.MutableExcludeListParameters.setLatestExcludeAutoCheckEnabled(boolean)

setLatestExcludeAutoCheckEnabled

public void setLatestExcludeAutoCheckEnabled(boolean b)
Description copied from interface: Parameters.MutableExcludeListParameters
Specify if the automatic check for newer exclude lists is enabled when the exclude list mode is set to LATEST_EXCLUDE_LIST.

Specified by:
setLatestExcludeAutoCheckEnabled in interface Parameters.MutableExcludeListParameters
Parameters:
b - whether or not the automatic check is enabled
See Also:
Parameters.MutableExcludeListParameters.isLatestExcludeAutoCheckEnabled()

getLatestExcludeAutoCheckMode

public int getLatestExcludeAutoCheckMode()
Description copied from interface: Parameters.MutableExcludeListParameters
Get the mode which defines how often to automatically check for updated exclude lists, when the exclude list mode is set to LATEST_EXCLUDE_LIST, and the automatic check is enabled.

Specified by:
getLatestExcludeAutoCheckMode in interface Parameters.MutableExcludeListParameters
Returns:
a value indicating how often to check for the availability of a newer exclude list
See Also:
Parameters.MutableExcludeListParameters.setLatestExcludeAutoCheckMode(int), Parameters.MutableExcludeListParameters.CHECK_EVERY_X_DAYS, Parameters.MutableExcludeListParameters.CHECK_EVERY_RUN

setLatestExcludeAutoCheckMode

public void setLatestExcludeAutoCheckMode(int mode)
Description copied from interface: Parameters.MutableExcludeListParameters
Set the mode which defines how often to automatically check for updated exclude lists, when the exclude list mode is set to LATEST_EXCLUDE_LIST, and the automatic check is enabled.

Specified by:
setLatestExcludeAutoCheckMode in interface Parameters.MutableExcludeListParameters
Parameters:
mode - a value indicating how often to check for the availability of a newer exclude list
See Also:
Parameters.MutableExcludeListParameters.getLatestExcludeAutoCheckMode(), Parameters.MutableExcludeListParameters.CHECK_EVERY_X_DAYS, Parameters.MutableExcludeListParameters.CHECK_EVERY_RUN

getLatestExcludeAutoCheckInterval

public int getLatestExcludeAutoCheckInterval()
Description copied from interface: Parameters.MutableExcludeListParameters
Get the interval, in days, to be used when automatically checking for exclude list updates and the auto check mode is set to CHECK_EVERY_X_DAYS.

Specified by:
getLatestExcludeAutoCheckInterval in interface Parameters.MutableExcludeListParameters
Returns:
the interval, in days, between checks
See Also:
Parameters.MutableExcludeListParameters.setLatestExcludeAutoCheckInterval(int)

setLatestExcludeAutoCheckInterval

public void setLatestExcludeAutoCheckInterval(int days)
Description copied from interface: Parameters.MutableExcludeListParameters
Set the interval, in days, to be used when automatically checking for exclude list updates and the auto check mode is set to CHECK_EVERY_X_DAYS.

Specified by:
setLatestExcludeAutoCheckInterval in interface Parameters.MutableExcludeListParameters
Parameters:
days - the number of days to wait between checks
See Also:
Parameters.MutableExcludeListParameters.getLatestExcludeAutoCheckInterval()

getKeywordsParameters

public Parameters.KeywordsParameters getKeywordsParameters()
Description copied from interface: Parameters
Get an object which provides access to the keywords object which identifies tests to be run according to their keywords.

Specified by:
getKeywordsParameters in interface Parameters
Returns:
an object which provides access to the keywords object which identifies tests to be run according to their keywords.

getKeywords

public Keywords getKeywords()
Description copied from interface: Parameters
Get a keywords object which identifies tests to be run according to their keywords.

Specified by:
getKeywords in interface Parameters
Specified by:
getKeywords in interface Parameters.KeywordsParameters
Returns:
a keywords object which identifies tests to be run according to their keywords.
See Also:
Parameters.KeywordsParameters.getKeywords()

setKeywords

public void setKeywords(int mode,
                        java.lang.String value)
Description copied from interface: Parameters.MutableKeywordsParameters
Set the details of the keywords to be used, if any, to filter tests for execution.

Specified by:
setKeywords in interface Parameters.MutableKeywordsParameters
Parameters:
mode - the value of the match keywords mode to be set if value is not null
value - if null, the keywords mode will be set to NO_KEYWORDS; if not null, the keywords mode will be set to MATCH_KEYWORDS, the match keywords mode will be set to mode, and the match keywords value will be set to this value
See Also:
Parameters.KeywordsParameters.getKeywords(), Parameters.MutableKeywordsParameters.NO_KEYWORDS, Parameters.MutableKeywordsParameters.MATCH_KEYWORDS

getKeywordsFilter

public TestFilter getKeywordsFilter()
Description copied from interface: Parameters
Get a filter which will filter tests according to the result of getKeywords(). If the result of getKeywords is null, the result of this method will also be null.

Specified by:
getKeywordsFilter in interface Parameters
Returns:
a filter which will filter tests according to the result of getKeywords().
See Also:
Parameters.getKeywords()

getKeywordsMode

public int getKeywordsMode()
Description copied from interface: Parameters.MutableKeywordsParameters
Get the current keywords mode.

Specified by:
getKeywordsMode in interface Parameters.MutableKeywordsParameters
Returns:
NO_KEYWORDS if no keyword filtering will be used to select tests for execution, or MATCH_KEYWORDS if keywords will be filtered according to the match mode and match value.
See Also:
Parameters.MutableKeywordsParameters.setKeywordsMode(int), Parameters.MutableKeywordsParameters.NO_KEYWORDS, Parameters.MutableKeywordsParameters.MATCH_KEYWORDS

setKeywordsMode

public void setKeywordsMode(int mode)
Description copied from interface: Parameters.MutableKeywordsParameters
Set the current keywords mode.

Specified by:
setKeywordsMode in interface Parameters.MutableKeywordsParameters
Parameters:
mode - set to NO_KEYWORDS if no keyword filtering will be used to select tests for execution, or MATCH_KEYWORDS if keywords will be filtered according to the match mode and match value.
See Also:
Parameters.MutableKeywordsParameters.getKeywordsMode(), Parameters.MutableKeywordsParameters.NO_KEYWORDS, Parameters.MutableKeywordsParameters.MATCH_KEYWORDS

getMatchKeywordsMode

public int getMatchKeywordsMode()
Description copied from interface: Parameters.MutableKeywordsParameters
Get a value which indicates how to interpret the match value, when the keywords mode is set to MATCH_KEYWORDS.

Specified by:
getMatchKeywordsMode in interface Parameters.MutableKeywordsParameters
Returns:
a value which indicates how to interpret the match value, when the keywords mode is set to MATCH_KEYWORDS
See Also:
Parameters.MutableKeywordsParameters.setMatchKeywords(int, java.lang.String), Parameters.MutableKeywordsParameters.ANY_OF, Parameters.MutableKeywordsParameters.ALL_OF, Parameters.MutableKeywordsParameters.EXPR

getMatchKeywordsValue

public java.lang.String getMatchKeywordsValue()
Description copied from interface: Parameters.MutableKeywordsParameters
Get a value that identifies which tests are to be selected, when the keywords mode is set to MATCH_KEYWORDS.

Specified by:
getMatchKeywordsValue in interface Parameters.MutableKeywordsParameters
Returns:
a value that identifies which tests are to be selected, when the keywords mode is set to MATCH_KEYWORDS
See Also:
Parameters.MutableKeywordsParameters.setMatchKeywords(int, java.lang.String), Parameters.MutableKeywordsParameters.ANY_OF, Parameters.MutableKeywordsParameters.ALL_OF, Parameters.MutableKeywordsParameters.EXPR

setMatchKeywords

public void setMatchKeywords(int mode,
                             java.lang.String value)
Description copied from interface: Parameters.MutableKeywordsParameters
Set how to match a tests keywords when the keywords mode is set to MATCH_KEYWORDS.

Specified by:
setMatchKeywords in interface Parameters.MutableKeywordsParameters
Parameters:
mode - A value indicating how to interpret value
value - If mode is set to ANY_OF or ALL_OF, this value should give a white-space separate list of keywords to be matched; if mode is set to EXPR, this value should be a boolean expression using terminals, & (and), | (or), ! (negation) and parentheses, where the terminals are true if a test description contains that name as one of its keywords.
See Also:
Parameters.MutableKeywordsParameters.getMatchKeywordsMode(), Parameters.MutableKeywordsParameters.getMatchKeywordsValue(), Parameters.MutableKeywordsParameters.ANY_OF, Parameters.MutableKeywordsParameters.ALL_OF, Parameters.MutableKeywordsParameters.EXPR

getPriorStatusParameters

public Parameters.PriorStatusParameters getPriorStatusParameters()
Description copied from interface: Parameters
Get an object which provides access to an array of booleans which identify tests to be run according to their prior execution status.

Specified by:
getPriorStatusParameters in interface Parameters
Returns:
an object which provides access to an array of booleans which identify tests to be run according to their prior execution status, or null if no such selection criteria is required.

getPriorStatusValues

public boolean[] getPriorStatusValues()
Description copied from interface: Parameters
Get an array of booleans which identify tests to be run according to their prior execution status. The array can be indexed by the constants Status.PASSED, Status.FAILED, Status.ERROR, and Status.NOT_RUN. For each of those values, if the corresponding boolean in the array is true, a test will be selected if its status matches the index. If the array is null, all tests will be selected.

Specified by:
getPriorStatusValues in interface Parameters
Specified by:
getPriorStatusValues in interface Parameters.PriorStatusParameters
Returns:
an array of booleans which identifying tests to be run according to their prior execution status, or null if no such criteria is required.
See Also:
Parameters.PriorStatusParameters.getPriorStatusValues()

setPriorStatusValues

public void setPriorStatusValues(boolean[] values)
Description copied from interface: Parameters.MutablePriorStatusParameters
Set which prior status values should be used, if any, to select tests for execution.

Specified by:
setPriorStatusValues in interface Parameters.MutablePriorStatusParameters
Parameters:
values - if null, the prior status mode will be set to NO_PRIOR_STATUS; if not null, the prior status mode will be set to MATCH_PRIOR_STATUS, and the matching values will be set to this array.
See Also:
Parameters.PriorStatusParameters.getPriorStatusValues()

getPriorStatusFilter

public TestFilter getPriorStatusFilter()
Description copied from interface: Parameters
Get a filter which will filter tests according to the result of getPriorStatusValus(). If the result of getPriorStatusValues is null, the result of this method will also be null.

Specified by:
getPriorStatusFilter in interface Parameters
Returns:
a filter which will filter tests according to the result of getPriorStatusValues().
See Also:
Parameters.getPriorStatusValues()

getPriorStatusMode

public int getPriorStatusMode()
Description copied from interface: Parameters.MutablePriorStatusParameters
Get the current mode determining whether tests are selected or not according to their prior execution status.

Specified by:
getPriorStatusMode in interface Parameters.MutablePriorStatusParameters
Returns:
a value of NO_PRIOR_STATUS indicates the prior execution status will not be taken into account; otherwise, a value of MATCH_PRIOR_STATUS means that tests will be selected if and only of their execution status matches one of the matching prior status values.
See Also:
Parameters.MutablePriorStatusParameters.setPriorStatusMode(int), Parameters.MutablePriorStatusParameters.NO_PRIOR_STATUS, Parameters.MutablePriorStatusParameters.MATCH_PRIOR_STATUS

setPriorStatusMode

public void setPriorStatusMode(int mode)
Description copied from interface: Parameters.MutablePriorStatusParameters
Set the current mode determining whether tests are selected or not according to their prior execution status.

Specified by:
setPriorStatusMode in interface Parameters.MutablePriorStatusParameters
Parameters:
mode - if set to NO_PRIOR_STATUS, the prior execution status will not be taken into account; otherwise, if set to MATCH_PRIOR_STATUS tests will be selected if and only of their execution status matches one of the matching prior status values.
See Also:
Parameters.MutablePriorStatusParameters.getPriorStatusMode(), Parameters.MutablePriorStatusParameters.NO_PRIOR_STATUS, Parameters.MutablePriorStatusParameters.MATCH_PRIOR_STATUS

getMatchPriorStatusValues

public boolean[] getMatchPriorStatusValues()
Description copied from interface: Parameters.MutablePriorStatusParameters
Get an array of booleans which identify which tests to be run, according to their prior execution status. The array can be indexed by the constants Status.PASSED, Status.FAILED, Status.ERROR, and Status.NOT_RUN. A test will be selected for execution if the entry in the array corresponding to the tests execution status is set to true.

Specified by:
getMatchPriorStatusValues in interface Parameters.MutablePriorStatusParameters
Returns:
an array of booleans which identifying the prior execution status of tests to be selected to be executed.
See Also:
Parameters.MutablePriorStatusParameters.setMatchPriorStatusValues(boolean[])

setMatchPriorStatusValues

public void setMatchPriorStatusValues(boolean[] v)
Description copied from interface: Parameters.MutablePriorStatusParameters
Set an array of booleans to identify which tests to be run, according to their prior execution status. The array can be indexed by the constants Status.PASSED, Status.FAILED, Status.ERROR, and Status.NOT_RUN. A test will be selected for execution if the entry in the array corresponding to the tests execution status is set to true.

Specified by:
setMatchPriorStatusValues in interface Parameters.MutablePriorStatusParameters
Parameters:
v - an array of booleans which identifying the prior execution status of tests to be selected to be executed.
See Also:
Parameters.MutablePriorStatusParameters.getMatchPriorStatusValues()

getConcurrencyParameters

public Parameters.ConcurrencyParameters getConcurrencyParameters()
Description copied from interface: Parameters
Get an object which provides access to the integer specifying the maximum number of tests that may be run in parallel.

Specified by:
getConcurrencyParameters in interface Parameters
Returns:
an object which provides access to the integer specifying the maximum number of tests that may be run in parallel.

getConcurrency

public int getConcurrency()
Description copied from interface: Parameters
Get an integer specifying the maximum number of tests that may be run in parallel.

Specified by:
getConcurrency in interface Parameters
Specified by:
getConcurrency in interface Parameters.ConcurrencyParameters
Returns:
an integer specifying the maximum number of tests that may be run in parallel
See Also:
Parameters.ConcurrencyParameters.getConcurrency()

setConcurrency

public void setConcurrency(int conc)
Description copied from interface: Parameters.MutableConcurrencyParameters
Set an integer specifying the maximum number of tests that may be run in parallel.

Specified by:
setConcurrency in interface Parameters.MutableConcurrencyParameters
Parameters:
conc - an integer specifying the maximum number of tests that may be run in parallel
See Also:
Parameters.ConcurrencyParameters.getConcurrency()

getTimeoutFactorParameters

public Parameters.TimeoutFactorParameters getTimeoutFactorParameters()
Description copied from interface: Parameters
Get an object which provides access to the integer specifying a scale factor to be applied to the standard timeout for the test.

Specified by:
getTimeoutFactorParameters in interface Parameters
Returns:
an object which provides access to the integer specifying a scale factor to be applied to the standard timeout for each test.

getTimeoutFactor

public float getTimeoutFactor()
Description copied from interface: Parameters
Get an integer specifying a scale factor to be applied to the standard timeout for the test.

Specified by:
getTimeoutFactor in interface Parameters
Specified by:
getTimeoutFactor in interface Parameters.TimeoutFactorParameters
Returns:
an integer specifying a scale factor to be applied to the standard timeout for each test.
See Also:
Parameters.TimeoutFactorParameters.getTimeoutFactor()

setTimeoutFactor

public void setTimeoutFactor(float tf)
Description copied from interface: Parameters.MutableTimeoutFactorParameters
Set an integer specifying a scale factor to be applied to the standard timeout for the test.

Specified by:
setTimeoutFactor in interface Parameters.MutableTimeoutFactorParameters
Parameters:
tf - an integer specifying a scale factor to be applied to the standard timeout for each test.
See Also:
Parameters.TimeoutFactorParameters.getTimeoutFactor()

getRelevantTestFilter

public TestFilter getRelevantTestFilter()
Description copied from interface: Parameters
Get a test-suite specific filter which will filter tests according to test-suite-specific criteria, as perhaps determined by a configuration interview. For example, if the platform being tested does not support some optional feature, the tests for that feature could be automatically filtered out. If no such filter is required, null can be returned.

Specified by:
getRelevantTestFilter in interface Parameters
Returns:
a test-suite-specific filter, or null if no such filter is required.

getFilters

public TestFilter[] getFilters()
Description copied from interface: Parameters
Get an array of the non-null filters returned from getExcludeListFilter, getKeywordsFilter, getPriorStatusFilter, and getRelevantTestFilter.

Specified by:
getFilters in interface Parameters
Returns:
an array of the non-null filters returned by the various getXXXFilter methods.
See Also:
Parameters.getExcludeListFilter(), Parameters.getKeywordsFilter(), Parameters.getPriorStatusFilter(), Parameters.getRelevantTestFilter()

isValid

public boolean isValid()
Description copied from interface: Parameters
Determine whether all the configuration values are valid. If so, the result will be true; if not, the result will be false, and getErrorMessage will provide details about at least one of the invalid values.

Specified by:
isValid in interface Parameters
Returns:
true if and only if all the configuration values are valid
See Also:
Parameters.getErrorMessage()

getErrorMessage

public java.lang.String getErrorMessage()
Description copied from interface: Parameters
If there is an error in any of the configuration values, as indicated by isValid, this method will provide a detail message about one or more of the invalid values. The result is undefined if isValid is true.

Specified by:
getErrorMessage in interface Parameters
Returns:
a detail message about one or more invalid values
See Also:
Parameters.isValid()

getAbsoluteFiles

protected static java.io.File[] getAbsoluteFiles(java.io.File baseDir,
                                                 java.io.File[] files)
Convert a set of files to be absolute files. Files that are already absolute are left unchanged; relative files are evaluated relative to a specified base directory.

Parameters:
baseDir - The base directory for any relative files
files - The files to be made absolute, or null if none
Returns:
the given files with any relative files having been evaluated relative to the given base directory, or null if files was null.

equal

protected static boolean equal(boolean[] b1,
                               boolean[] b2)
Compare two boolean arrays for equality.

Parameters:
b1 - the first array to be compared
b2 - the second array to be compared
Returns:
true and only if both arguments are null, or if both are not null and are element-wise equal.

equal

protected static boolean equal(java.io.File[] f1,
                               java.io.File[] f2)
Compare two arrays of Files for equality.

Parameters:
f1 - the first array to be compared
f2 - the second array to be compared
Returns:
true and only if both arguments are null, or if both are not null and are element-wise equal.


Copyright (c) 1996, 2010, Oracle and/or its affiliates. All rights reserved.