Package com.sun.javatest
Class BasicParameters
java.lang.Object
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 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
FieldsModifier and TypeFieldDescriptionprotected String
A string to identify any errors that may have occurred when setting the concurrency, or null if there were no such errors.protected String
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 String
A string to identify any errors that may have occurred when setting the keywords parameters, or null if there were no such errors.protected String
A string to identify any errors that may have occurred when setting the test suite, or null if there were no such errors.protected String
A string to identify any errors that may have occurred when setting the timeout factor, or null if there were no such errors.protected String
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.ConcurrencyParameters
MAX_CONCURRENCY, MIN_CONCURRENCY
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.MutableTestsParameters
ALL_TESTS, SPECIFIED_TESTS
Fields inherited from interface com.sun.javatest.Parameters.TimeoutFactorParameters
MAX_TIMEOUT_FACTOR, MIN_TIMEOUT_FACTOR
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected static boolean
equal
(boolean[] b1, boolean... b2) Compare two boolean arrays for equality.protected static boolean
Compare two arrays of Files for equality.protected static File[]
getAbsoluteFiles
(File baseDir, File... files) Convert a set of files to be absolute files.int
Get an integer specifying the maximum number of tests that may be run in parallel.Get an object which provides access to the integer specifying the maximum number of tests that may be run in parallel.File[]
Get the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.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.File[]
Get the set of files which define the exclude list.Get an exclude list which identifies tests or test cases to be excluded from the test run.Get a filter which will filter tests according to the result of getExcludeList().Get an object which provides access to the exclude list which identifies tests or test cases to be excluded from the test run.int
Get the current exclude list mode.Get an array of the non-null filters returned from getExcludeListFilter, getKeywordsFilter, getPriorStatusFilter, and getRelevantTestFilter.Get a keywords object which identifies tests to be run according to their keywords.Get a filter which will filter tests according to the result of getKeywords().int
Get the current keywords mode.Get an object which provides access to the keywords object which identifies tests to be run according to their keywords.int
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
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
Get a value which indicates how to interpret the match value, when the keywords mode is set to MATCH_KEYWORDS.Get a value that identifies which tests are to be selected, when the keywords mode is set to MATCH_KEYWORDS.boolean[]
Get an array of booleans which identify which tests to be run, according to their prior execution status.Get a filter which will filter tests according to the result of getPriorStatusValus().int
Get the current mode determining whether tests are selected or not according to their prior execution status.Get an object which provides access to an array of booleans which identify tests to be run according to their prior execution status.boolean[]
Get an array of booleans which identify tests to be run according to their prior execution status.Get a test-suite specific filter which will filter tests according to test-suite-specific criteria, as perhaps determined by a configuration interview.String[]
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.String[]
getTests()
Get the paths identifying the tests or folders of tests within the test suite to be run.int
Get the current mode for how the tests are specified.Get an object which provides access to the paths identifying the tests or folders of tests to be run.Get the test suite for which these parameters apply.float
Get an integer specifying a scale factor to be applied to the standard timeout for the test.Get an object which provides access to the integer specifying a scale factor to be applied to the standard timeout for the test.Get the work directory in which to store the results of the test run.boolean
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
(File... files) Set the files used to define the exclude list when the exclude list mode is set to CUSTOM_EXCLUDE_LIST.void
setExcludeFiles
(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, 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, 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
(String... tests) Set the specified tests to be be run when the mode is set to SPECIFIED_TESTS.void
Specify the tests to be executed.void
setTestsMode
(int mode) Set the current mode for how the tests are specified.void
Set the test suite for the test run.void
setTestSuite
(File file) 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
Set the work directory for the test run.void
setWorkDirectory
(File dir) 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 Details
-
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
A string to identify any errors that may have occurred when setting the work directory, or null if there were no such errors. -
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
A string to identify any errors that may have occurred when setting the keywords parameters, or null if there were no such errors. -
concurrencyError
A string to identify any errors that may have occurred when setting the concurrency, or null if there were no such errors. -
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 Details
-
BasicParameters
public BasicParameters()
-
-
Method Details
-
getAbsoluteFiles
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 filesfiles
- 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 comparedb2
- 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
Compare two arrays of Files for equality.- Parameters:
f1
- the first array to be comparedf2
- 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.
-
getTestSuite
Description copied from interface:Parameters
Get the test suite for which these parameters apply.- Specified by:
getTestSuite
in interfaceParameters
- Returns:
- the test suite for which these parameters apply.
- See Also:
-
setTestSuite
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:
-
setTestSuite
Set the test suite for the test run. The test suite may only be set once.- Specified by:
setTestSuite
in interfaceParameters
- Parameters:
ts
- the test suite to be set.- Throws:
NullPointerException
- if ts is nullIllegalStateException
- if the test suite has already been set to something different- See Also:
-
getWorkDirectory
Description copied from interface:Parameters
Get the work directory in which to store the results of the test run.- Specified by:
getWorkDirectory
in interfaceParameters
- Returns:
- the work directory in which to store the results of the test run.
- See Also:
-
setWorkDirectory
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:
-
setWorkDirectory
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 interfaceParameters
- Parameters:
wd
- the work directory to be set.- Throws:
NullPointerException
- if wd is nullIllegalStateException
- if the work directory has already been set to something different- See Also:
-
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 interfaceParameters
- Returns:
- an object which provides access to the paths identifying tests to be run.
-
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 interfaceParameters
- Specified by:
getTests
in interfaceParameters.TestsParameters
- Returns:
- an array of paths identifying the tests to be run
- See Also:
-
setTests
Description copied from interface:Parameters.MutableTestsParameters
Specify the tests to be executed.- Specified by:
setTests
in interfaceParameters.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:
-
getTestsMode
public int getTestsMode()Description copied from interface:Parameters.MutableTestsParameters
Get the current mode for how the tests are specified.- Specified by:
getTestsMode
in interfaceParameters.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:
-
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 interfaceParameters.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:
-
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 interfaceParameters.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:
-
setSpecifiedTests
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 interfaceParameters.MutableTestsParameters
- Parameters:
tests
- an array of paths identifying the tests to be run- See Also:
-
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 interfaceParameters
- Returns:
- an object which provides access to the exclude list identifying tests or test cases to be excluded from the test run.
-
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 interfaceParameters.MutableExcludeListParameters
- Returns:
- the set of files which define the exclude list
- See Also:
-
setExcludeFiles
Description copied from interface:Parameters.MutableExcludeListParameters
Set the set of files used to define the exclude list.- Specified by:
setExcludeFiles
in interfaceParameters.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:
-
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 interfaceParameters
- Specified by:
getExcludeList
in interfaceParameters.ExcludeListParameters
- Returns:
- an exclude list identifying tests or test cases to be excluded from the test run.
- See Also:
-
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 interfaceParameters
- Returns:
- a filter which will filter tests according to the result of getExcludeList().
- See Also:
-
getExcludeMode
public int getExcludeMode()Description copied from interface:Parameters.MutableExcludeListParameters
Get the current exclude list mode.- Specified by:
getExcludeMode
in interfaceParameters.MutableExcludeListParameters
- Returns:
- A value indicating the current exclude list mode
- See Also:
-
setExcludeMode
public void setExcludeMode(int mode) Description copied from interface:Parameters.MutableExcludeListParameters
Set the current exclude list mode.- Specified by:
setExcludeMode
in interfaceParameters.MutableExcludeListParameters
- Parameters:
mode
- A value indicating the desired exclude list mode- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Returns:
- the files used to define a custom exclude list
- See Also:
-
setCustomExcludeFiles
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 interfaceParameters.MutableExcludeListParameters
- Parameters:
files
- the files used to define a custom exclude list- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Returns:
- true if the automatic check is enabled
- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Parameters:
b
- whether or not the automatic check is enabled- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Returns:
- a value indicating how often to check for the availability of a newer exclude list
- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Parameters:
mode
- a value indicating how often to check for the availability of a newer exclude list- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Returns:
- the interval, in days, between checks
- See Also:
-
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 interfaceParameters.MutableExcludeListParameters
- Parameters:
days
- the number of days to wait between checks- See Also:
-
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 interfaceParameters
- Returns:
- an object which provides access to the keywords object which identifies tests to be run according to their 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 interfaceParameters
- Specified by:
getKeywords
in interfaceParameters.KeywordsParameters
- Returns:
- a keywords object which identifies tests to be run according to their keywords.
- See Also:
-
setKeywords
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 interfaceParameters.MutableKeywordsParameters
- Parameters:
mode
- the value of the match keywords mode to be set ifvalue
is not nullvalue
- 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 tomode
, and the match keywords value will be set to this value- See Also:
-
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 interfaceParameters
- Returns:
- a filter which will filter tests according to the result of getKeywords().
- See Also:
-
getKeywordsMode
public int getKeywordsMode()Description copied from interface:Parameters.MutableKeywordsParameters
Get the current keywords mode.- Specified by:
getKeywordsMode
in interfaceParameters.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:
-
setKeywordsMode
public void setKeywordsMode(int mode) Description copied from interface:Parameters.MutableKeywordsParameters
Set the current keywords mode.- Specified by:
setKeywordsMode
in interfaceParameters.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:
-
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 interfaceParameters.MutableKeywordsParameters
- Returns:
- a value which indicates how to interpret the match value, when the keywords mode is set to MATCH_KEYWORDS
- See Also:
-
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 interfaceParameters.MutableKeywordsParameters
- Returns:
- a value that identifies which tests are to be selected, when the keywords mode is set to MATCH_KEYWORDS
- See Also:
-
setMatchKeywords
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 interfaceParameters.MutableKeywordsParameters
- Parameters:
mode
- A value indicating how to interpretvalue
value
- Ifmode
is set to ANY_OF or ALL_OF, this value should give a white-space separate list of keywords to be matched; ifmode
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:
-
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 interfaceParameters
- 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 interfaceParameters
- Specified by:
getPriorStatusValues
in interfaceParameters.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:
-
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 interfaceParameters.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:
-
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 interfaceParameters
- Returns:
- a filter which will filter tests according to the result of getPriorStatusValues().
- See Also:
-
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 interfaceParameters.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:
-
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 interfaceParameters.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:
-
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 constantsStatus.PASSED
,Status.FAILED
,Status.ERROR
, andStatus.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 interfaceParameters.MutablePriorStatusParameters
- Returns:
- an array of booleans which identifying the prior execution status of tests to be selected to be executed.
- See Also:
-
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 constantsStatus.PASSED
,Status.FAILED
,Status.ERROR
, andStatus.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 interfaceParameters.MutablePriorStatusParameters
- Parameters:
v
- an array of booleans which identifying the prior execution status of tests to be selected to be executed.- See Also:
-
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 interfaceParameters
- 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 interfaceParameters
- Specified by:
getConcurrency
in interfaceParameters.ConcurrencyParameters
- Returns:
- an integer specifying the maximum number of tests that may be run in parallel
- See Also:
-
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 interfaceParameters.MutableConcurrencyParameters
- Parameters:
conc
- an integer specifying the maximum number of tests that may be run in parallel- See Also:
-
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 interfaceParameters
- 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 interfaceParameters
- Specified by:
getTimeoutFactor
in interfaceParameters.TimeoutFactorParameters
- Returns:
- an integer specifying a scale factor to be applied to the standard timeout for each test.
- See Also:
-
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 interfaceParameters.MutableTimeoutFactorParameters
- Parameters:
tf
- an integer specifying a scale factor to be applied to the standard timeout for each test.- See Also:
-
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 interfaceParameters
- Returns:
- a test-suite-specific filter, or null if no such filter is required.
-
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 interfaceParameters
- Returns:
- an array of the non-null filters returned by the various getXXXFilter methods.
- See Also:
-
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 interfaceParameters
- Returns:
- true if and only if all the configuration values are valid
- See Also:
-
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 interfaceParameters
- Returns:
- a detail message about one or more invalid values
- See Also:
-