Package com.sun.javatest
Tests are represented by test descriptions
,
which are contained in a test suite
. They are
read by a test finder
, and executed by a
test script
, to produce a
test result
. Internally, the test results
are stored in a test result table
;
externally, the results are stored in a
work directory
.
Some configuration parameters
are required
in order to read and run tests: these parameters may be collected by
a configuration interview
.
Some limited support is also provided for an earlier parameter mechanism
based on parameter files
.
The finder used to locate the tests, the interview used to configure them and the script used to execute them are all determined by the test suite of which they are part.
- Since:
- 3.0
-
Interface Summary Interface Description Harness.Observer This interface provides a means for Harness to report on events that might be of interest as it executes.InterviewParameters.TemplateManager The template manager is used to change behavior of template saving, the default implementation is the context manager of corresponding test suite.InterviewPropagator.TestRefresher InterviewPropagator.ViewManager ObservableTestFilter.Observer An observer that is notified when the filter has been changed.Parameters Configuration parameters for a test run.Parameters.ConcurrencyParameters An interface providing basic abstract access to an integer specifying the maximum number of tests that can be run in parallel.Parameters.EnvParameters An interface providing basic abstract access to the environment used to run each test.Parameters.ExcludeListParameters An interface providing basic abstract access to an exclude list, defining tests to be excluded from the test run.Parameters.KeywordsParameters An interface providing basic abstract access to a keywords object which can be used to select tests according to their keywords.Parameters.LegacyEnvParameters An interface providing abstract access to environments, as contained in a set of .jte files, as used by older, legacy test suites.Parameters.MutableConcurrencyParameters An interface providing abstract access to an integer specifying the maximum number of tests that can be run in parallel.Parameters.MutableExcludeListParameters An interface providing abstract access to an exclude list, as defined by a set of files, defining tests to be excluded from the test run.Parameters.MutableKeywordsParameters An interface providing abstract access to a keywords object which can be used to select tests according to their keywords.Parameters.MutablePriorStatusParameters An interface providing abstract access to a set of booleans which can be used to select tests according to their prior execution status.Parameters.MutableTestsParameters An interface providing abstract access to a set of paths defining the tests and folders of tests to be run.Parameters.MutableTimeoutFactorParameters An interface providing abstract access to an integer specifying a scale factor for the standard timeout used for each test.Parameters.PriorStatusParameters An interface providing basic abstract access to a set of booleans which can be used to select tests according to their prior execution status.Parameters.TestsParameters An interface providing basic abstract access to the set of paths defining the tests and folders of tests to be run.Parameters.TimeoutFactorParameters An interface providing basic abstract access to an integer specifying a scale factor for the standard timeout used for each test.Script.TimeoutProvider Interface for extended testTimeout control.Test This interface is implemented by tests to be run by standard scripts.TestFilter.Observer An interface for notification about why a test has been filtered out.TestFinder.ErrorHandler This interface is used to report significant errors found while reading files, but which are not of themselves serious enough to stop reading further.TestFinderQueue.Observer This interface provides a means for TestFinder to report on events that might be of interest as it executes.TestResult.Observer An interface to observe activity in a TestResult as it is created.TestResultCache.Observer Interface which allows an external class to monitor the cache's activities.TestResultTable.Observer Observer to monitor changes to a TestResultTable.TestResultTable.TreeEventObserver Extension to TreeObserver to receive notifications related to events happened on tree nodes.TestResultTable.TreeIterator Defines an iterator/enumerator interface for retrieving tests out of the tree.TestResultTable.TreeNode Interface to a node which contitutes the skeleton of the test result tree.TestResultTable.TreeNodeObserver Observer interface to watch a single tree node.TestResultTable.TreeObserver Tree-aware observer of the TRT. -
Class Summary Class Description AllTestsFilter Basic filter which accepts all tests presented to it.BasicParameters A basic implementation of Parameters for all except the EnvParameters subsection.Command Command provides the ability to invoke arbitrary Java code from within a Script.CompositeFilter A filter which uses one or more filters to implement its accept method.DefaultTestRunner Traditional implementation of the test execution engine which has been used throughout the JT Harness 2.x harness.EditJTI This class provides a utility for command-line editing of configuration (.jti) files.EditLinks A utility to rewrite links within a set of HTML files.ExcludeList A set of tests to be excluded from a test run.ExcludeList.Entry An entry in the exclude list.ExcludeListFilter A test filter that filters out tests that appear in anExcludeList
.ExcludeListUpdateHandler A class to handle downloading exclude lists from a server.FileParameters An implementation of Parameters, using data read from a .jtp file.Harness The object responsible for coordinating the execution of a test run.InitialUrlFilter Filters tests based on a set of initial files or URLs.InterviewParameters Configuration parameters provided via an interview.InterviewPropagator JavaTestSecurityManager This class is set for JT Harness running as an application.Keywords A filter for sets of keywords, as found on test descriptions.KeywordsFilter A test filter that filters tests according to the keywords on a test description.KnownFailuresList Support class to read and process a list of tests and test cases which are known to fail during execution.KnownFailuresList.Entry An entry in the exclude list.LastRunFilter This filter designed to show only the results from the last test run.LastRunInfo Information about the last or current test run.ObservableTestFilter An extension to the basic test filter which provides observer capabilities.ParameterFilter This filter knows how to deal with the the Parameters interface to get the necessary filtering effect.ProductInfo Information about this release of the JT Harness test harness.ResourceLoader ResourceTable A table providing simple named locks for arbitrary resources.Script Script is the abstract base class providing the ability to control how a test is to be compiled and executed.Status A class to embody the result of a test: a status-code and a related message.StatusFilter A test filter that filters tests according to their prior execution status.TemplateUtilities Template support utility methods.TemplateUtilities.ConfigInfo TestDescription TestDescription objects embody the parameters of a test and provide the ability to run a test.TestEnvContext A table representing the collection of environments found in a set of environment files.TestEnvironment This class provides "environments", as embodied by groups of related properties.TestFilter A filter interface for TestDescriptions.TestFinder Base implementation for test finders which search for test descriptions given a starting location.TestFinderQueue An iterator-based interface to the tests in a test suite, as read by a test finder.TestResult The TestResult object encapsulates the results from a test.TestResultCache Class which maintains a cache of the results currently existing inside a work directory.TestResultTable Collected results from a test suite.TestRunner TestRunner is the abstract base class providing the ability to control how tests are run.TestSuite A class providing information about and access to the tests in a test suite.TRT_TreeNode This is the implementation of a tree node structure for TestResultTable.WorkDirectory A class providing access to the working state of a test run, as embodied in a work directory. -
Exception Summary Exception Description EditJTI.BadArgs This exception is used to indicate a problem with the command line arguments.EditJTI.Fault This exception is used to report problems that arise when using this API.EditLinks.BadArgs An exception to report bad command line arguments.ExcludeList.Fault This exception is used to report problems manipulating an exclude list.Harness.Fault This exception is used to report problems while executing a test run.InterviewParameters.JTIFault Indicates problems when accessing the configuration file.InterviewParameters.TestSuiteFault Indicates problems when accessing the test suite.InterviewParameters.WorkDirFault Indicates problems when accessing the work directory.Keywords.Fault An exception used to report errors while using a Keywords object.KnownFailuresList.Fault This exception is used to report problems manipulating an exclude list.TestEnvContext.Fault This exception is to report problems usingTestEnvContext
objects.TestEnvironment.Fault This exception is used to report resolving values in an environment.TestFilter.Fault This exception is to report problems that occur while filtering tests.TestFinder.Fault This exception is to report serious problems that occur while finding tests.TestResult.Fault This exception is to report problems using TestResult objects.TestResult.ReloadFault This exception ay occur anytime the JTR file is being read from the filesystem.TestResult.ResultFileNotFoundFault This exception is thrown if the JTR file cannot be found.TestResultTable.Fault Exception class to communicate any special conditions which may occur while using this class.TestSuite.DuplicateLogNameFault TestSuite.Fault An exception used to report errors while using a TestSUite object.TestSuite.NoSuchLogFault TestSuite.NotTestSuiteFault An exception that is used to report that a given file is not a test suite.TRT_TreeNode.Fault WorkDirectory.BadDirectoryFault Signals that there is a serious, unrecoverable problem when trying to open or create a work directory.WorkDirectory.Fault This exception is used to report problems that arise when using work directories.WorkDirectory.InitializationFault Signals that there is a problem trying to initialize from the data in the work directory.WorkDirectory.MismatchFault Signals that a work directory does not match the given test suite.WorkDirectory.NotWorkDirectoryFault Signals that a directory (while valid in itself) is not a valid work directory.WorkDirectory.PurgeFault Signals that a problem occurred while trying to purge files in work directory.WorkDirectory.TemplateMissingFault Signals that the template pointed to by that directory is missing.WorkDirectory.TestSuiteFault Signals that there is a problem trying to determine the test suite appropriate for the work directory.WorkDirectory.WorkDirectoryExistsFault Signals that a work directory already exists when an attempt is made to create one. -
Error Summary Error Description JavaTestError Special error class to be used for errors which may pop out of JT Harness and be seen by the user.