Class RandomTestFinder

java.lang.Object

com.sun.javatest.TestFinder

com.sun.javatest.finder.RandomTestFinder

public class RandomTestFinder
extends TestFinder

A test finder that reads tests from a delegate, and returns the results in the random order. This is primarily for debugging and testing purposes.

Nested Class Summary

Nested classes/interfaces inherited from class TestFinder

TestFinder.ErrorHandler, TestFinder.Fault

Field Summary

Fields inherited from class TestFinder

debug, env

Constructor Summary

Constructors

Constructor	Description
RandomTestFinder(TestFinder delegate)	Constructor to create RandomTestFinder object when the original TestFinder instance is already created and initialized.

Method Summary

Modifier and Type	Method	Description
File[]	getFiles()	Get the files that were found by the most recent call of read.
File	getRoot()	Get the root file of the test suite, as passed in to the init method.
File	getRootDir()	Get the root directory of the test suite; this is either the root passed in to the init method or if that is a file, it is the directory containing the file.
TestDescription[]	getTests()	Get the test descriptions that were found by the most recent call of read.
void	read(File file)	Read a file, looking for test descriptions and other files that might need to be read.
protected void	scan(File file)	Scan a file, looking for test descriptions and other files that might need to be scanned.

Methods inherited from class TestFinder

clearErrors, decodeAllArgs, decodeArg, error, error, error, foundFile, foundTestDescription, foundTestDescription, getComparator, getDefaultComparator, getErrorCount, getErrorHandler, getErrors, init, init, isFolder, lastModified, localizedError, normalize, processEntry, setComparator, setErrorHandler, setRoot, totalNumberOfTestsInTheSuite

Methods inherited from class Object

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

Constructor Details

RandomTestFinder

public RandomTestFinder(TestFinder delegate)

Constructor to create RandomTestFinder object when the original TestFinder instance is already created and initialized. Finders created with this constructor do not require the init() method to be invoked.

Parameters:

delegate - - the real test finder object.

Method Details

getRoot

public File getRoot()

Description copied from class: TestFinder

Get the root file of the test suite, as passed in to the init method.

Overrides:

getRoot in class TestFinder

Returns:

the root file of the test suite

See Also:

• TestFinder.setRoot(File)

getRootDir

public File getRootDir()

Description copied from class: TestFinder

Get the root directory of the test suite; this is either the root passed in to the init method or if that is a file, it is the directory containing the file.

Overrides:

getRootDir in class TestFinder

Returns:

the root directory of the test suite

read

public void read(File file)

Description copied from class: TestFinder

Read a file, looking for test descriptions and other files that might need to be read. If the file is relative, it will be evaluated relative to getRootDir. Depending on the test finder, the file may be either a plain file or a directory.

Overrides:

read in class TestFinder

Parameters:

file - The file to be read.

getTests

public TestDescription[] getTests()

Description copied from class: TestFinder

Get the test descriptions that were found by the most recent call of read.

Overrides:

getTests in class TestFinder

Returns:

the test descriptions that were found by the most recent call of read.

See Also:

• TestFinder.read(File)
• TestFinder.foundTestDescription(Map, File, int)

getFiles

public File[] getFiles()

Description copied from class: TestFinder

Get the files that were found by the most recent call of read.

Overrides:

getFiles in class TestFinder

Returns:

the files that were found by the most recent call of read.

See Also:

• TestFinder.read(File)
• TestFinder.foundFile(File)

scan

protected void scan(File file)

Description copied from class: TestFinder

Scan a file, looking for test descriptions and other files that might need to be scanned. The implementation depends on the type of test finder.

Specified by:

scan in class TestFinder

Parameters:

file - The file to scan