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:
  • 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