TestFinderDecorator (JT Harness Version 5.0)

java.lang.Object
- com.sun.javatest.TestFinder
- - com.sun.javatest.finder.TestFinderDecorator

```
public class TestFinderDecorator
extends TestFinder
```
A test finder decorator that reads tests from a delegate, and returns the results in the reverse/random order. This is primarily for debugging and testing purposes.

Nested Class Summary
- Nested classes/interfaces inherited from class com.sun.javatest.TestFinder
  TestFinder.ErrorHandler, TestFinder.Fault

Field Summary
- Fields inherited from class com.sun.javatest.TestFinder
  debug, env

Constructor Summary

Constructors
Constructor and Description

TestFinderDecorator(TestFinder testFinder)
Default constructor

Constructors
Constructor and Description
`TestFinderDecorator(TestFinder testFinder)` Default constructor

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.util.Comparator`	`getComparator()` Get the current comparator being used.
`TestFinder`	`getCurrentTestFinder()`
`java.io.File[]`	`getFiles()` Get the files that were found by the most recent call of read.
`java.io.File`	`getRoot()` Get the root file of the test suite, as passed in to the `init` method.
`java.io.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.
`boolean`	`isFolder(java.io.File path)` Determine whether a location corresponds to a directory (folder) or an actual file.
`long`	`lastModified(java.io.File f)` Determine when the last time this path was modified.
`void`	`read(java.io.File file)` Read a file, looking for test descriptions and other files that might need to be read.
`protected void`	`scan(java.io.File file)` Scan a file, looking for test descriptions and other files that might need to be scanned.
`void`	`setComparator(java.util.Comparator c)` Incoming files and test descriptions are sorted by their name during processing, this method allows adjustment of the comparison method to be used during this sorting.

Methods inherited from class com.sun.javatest.TestFinder
clearErrors, decodeAllArgs, decodeArg, error, error, error, foundFile, foundTestDescription, foundTestDescription, getDefaultComparator, getErrorCount, getErrorHandler, getErrors, init, init, localizedError, normalize, processEntry, setErrorHandler, setRoot

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TestFinderDecorator
```
public TestFinderDecorator(TestFinder testFinder)
```
    Default constructor
- Method Detail
  - getRoot
```
public java.io.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(java.io.File)
  - getRootDir
```
public java.io.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(java.io.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(java.io.File), TestFinder.foundTestDescription(java.util.Map, java.io.File, int)
  - getFiles
```
public java.io.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(java.io.File), TestFinder.foundFile(java.io.File)
  - getComparator
```
public java.util.Comparator getComparator()
```
    Description copied from class: TestFinder
    
    Get the current comparator being used.
    
    Overrides:
    
    getComparator in class TestFinder
    
    Returns:
    
    The current comparator, may be null.
    
    See Also:
    
    TestFinder.setComparator(java.util.Comparator)
  - setComparator
```
public void setComparator(java.util.Comparator c)
```
    Description copied from class: TestFinder
    
    Incoming files and test descriptions are sorted by their name during processing, this method allows adjustment of the comparison method to be used during this sorting. Sorting can be disabled by calling this method with a null parameter. By default, this class will do US Locale sorting.
    
    Overrides:
    
    setComparator in class TestFinder
    
    Parameters:
    
    c - The comparison operator to be used. Null indicates no sorting (old behavior).
    
    See Also:
    
    TestFinder.getComparator(), TestFinder.foundTestDescription(TestDescription), TestFinder.foundFile(File)
  - getCurrentTestFinder
```
public TestFinder getCurrentTestFinder()
```
  - lastModified
```
public long lastModified(java.io.File f)
```
    Description copied from class: TestFinder
    
    Determine when the last time this path was modified. This is used to decide whether to rescan that location or not. The default implementation defers the choice to the java.
    
    Overrides:
    
    lastModified in class TestFinder
    
    Parameters:
    
    f - The location in question.
  - isFolder
```
public boolean isFolder(java.io.File path)
```
    Description copied from class: TestFinder
    
    Determine whether a location corresponds to a directory (folder) or an actual file. If the finder implementation chooses, the locations used in read() and scan() may be real or virtual. This method will be queried to determine if a location is a container or something that should be scanned for tests. If it is both...
    
    Overrides:
    
    isFolder in class TestFinder
    
    Parameters:
    
    path - The location in question.
  - scan
```
protected void scan(java.io.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

Class TestFinderDecorator

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.javatest.TestFinder

Field Summary

Fields inherited from class com.sun.javatest.TestFinder

Constructor Summary

Method Summary

Methods inherited from class com.sun.javatest.TestFinder

Methods inherited from class java.lang.Object

Constructor Detail

TestFinderDecorator

Method Detail

getRoot

getRootDir

read

getTests

getFiles

getComparator

setComparator

getCurrentTestFinder

lastModified

isFolder

scan