Class TestFilter

java.lang.Object

com.sun.javatest.TestFilter

Direct Known Subclasses:

AllTestsFilter, CompositeFilter, ExcludeListFilter, InitialUrlFilter, KeywordsFilter, ObservableTestFilter, StatusFilter

public abstract class TestFilter
extends Object

A filter interface for TestDescriptions.

Implementations of this class should implement the equals() and hashCode() as per the spec in java.lang.Object. This is used by the harness for file equality purposes which looking for changes and optimizations to perform.

See Also:

• TestDescription

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TestFilter.Fault	This exception is to report problems that occur while filtering tests.
static interface	TestFilter.Observer	An interface for notification about why a test has been filtered out.

Constructor Summary

Constructors

Constructor	Description
TestFilter()

Method Summary

Modifier and Type	Method	Description
abstract boolean	accepts(TestDescription td)	Determines whether a TestDescription should be accepted or rejected by this filter.
boolean	accepts(TestDescription td, TestFilter.Observer o)	Determines whether a TestDescription should be accepted or rejected by this filter; if rejected, it is reported to the provided observer.
boolean	accepts(TestResult tr)
boolean	accepts(TestResult tr, TestFilter.Observer o)
abstract String	getDescription()	Get a description of this filter, as might be used to give more details about this filter than provided by getName().
abstract String	getName()	Get the name of this filter, as might be used to choose of of a set of filters.
abstract String	getReason()	Get the reason why this filter would reject a test, as might be used in reports.

Methods inherited from class Object

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

Constructor Details

TestFilter

public TestFilter()

Method Details

getName

public abstract String getName()

Get the name of this filter, as might be used to choose of of a set of filters. This string should be localized.

Returns:

the name of this filter

getDescription

public abstract String getDescription()

Get a description of this filter, as might be used to give more details about this filter than provided by getName(). This string should be localized.

Returns:

a description of this filter

getReason

public abstract String getReason()

Get the reason why this filter would reject a test, as might be used in reports. This string should be localized.

Returns:

a rejection reason for this filter

accepts

public abstract boolean accepts(TestDescription td)
                         throws TestFilter.Fault

Determines whether a TestDescription should be accepted or rejected by this filter.

Parameters:

td - the TestDescription to check

Returns:

true if td should be included in collection; false otherwise.

Throws:

TestFilter.Fault - if an error occurs while trying to determine if this test should be accepted or not.

accepts

public boolean accepts(TestResult tr)
                throws TestFilter.Fault,
TestResult.Fault

Throws:

TestFilter.Fault

TestResult.Fault

accepts

public boolean accepts(TestDescription td,
 TestFilter.Observer o)
                throws TestFilter.Fault

Determines whether a TestDescription should be accepted or rejected by this filter; if rejected, it is reported to the provided observer.

Parameters:

td - The TestDescription to check.

o - An observer, which will be notified if the test is rejected by this filter.

Returns:

true if td should be included in collection; false otherwise.

Throws:

TestFilter.Fault - if an error occurs while trying to determine if this test should be accepted or not.

accepts

public boolean accepts(TestResult tr,
 TestFilter.Observer o)
                throws TestFilter.Fault,
TestResult.Fault

Throws:

TestFilter.Fault

TestResult.Fault