JT Harness Source Code Description

The JT harness source code is divided into areas based on their responsibility or whether they are general versus or specific. The core of the harness is in one package, the generic GUI framework in another, while sub-packages contain more specific GUI subsystems that plug into the generic framework. An implication of this is that there are clearly defined interfaces between packages because the Java™ programming language does not have a "friend" mechanism.

Packages

Located in the src/ directory under the root of the Mercurial project tree:

com.sun.javatest

The core of the JT harness. Many base classes and interfaces are defined here, for example: TestFinder, Script, and TestEnvironment. Most sub-packages reference classes from this package. In order to prevent the initialization of those libraries when running in CLI mode, it is important that no class in this package reference AWT or Swing.

com.sun.javatest.util

The core of the JT harness. Many base classes and interfaces are defined here, for example: TestFinder, Script, and TestEnvironment. Most sub-packages reference classes from this package. In order to prevent the initialization of those libraries when running in CLI mode, it is important that no class in this package reference AWT or Swing. com.sun.javatest.util

com.sun.javatest.lib

Contains concrete implementations of plug-in classes (TestFinder, Script, Test). Do not add GUI code to this package.

com.sun.javatest.finder

Similar to com.sun.javatest.lib, but for TestFinder classes. Contains many implementations and most test suites use these either directly or as a sub-class. Do not add GUI code to this package.

com.sun.javatest.report

Contains all implementations of the reporting code, both HTML and plain text. Future report types may be located here or in a sub-package.

Code Block

language	none

com.sun.javatest.tool

This

is

the

core

GUI

framework

for

the

JT

harness

GUI

interface.

The

GUI

interface

is

defined

by

the

Desktop

at

the

top

level,

with

Tools

below

that.

The

GUI

in

which

you

execute

tests

is

a

Tool

whose

implementation

is

not

in

this

package.

This

package

controls

things

such

as

menu

organization,

top-level

window

arrangement

(desktop

style),

and

the

preference

dialog.

This

package

also

contains

the

entry

point

for

the

JT

harness:

com.sun.javatest.tool.Main.

com.sun.javatest.exec

The

"Exec

Tool"

is

also

known

as

the

"Test

Manager."

This

is

the

GUI

used

for

test

execution

functionality.

Code

for

the

Configuration

Editor

is

also

contained

here.

This

is

what

most

people

think

of

as

the

core

the

JT

harness

GUI

functionality.

com.sun.javatest.exec.template

Support

classes

for

GUI

template

handling.

com.sun.javatest.batch

Command-line

interface

support

classes.

com.sun.interview

Generic

interview

API.

com.sun.interview.wizard

GUI

rendering

components

for

the

interview

question

types.

com.sun.javatest.interview

Concrete

implementations

of

the

interview

classes.

Also

contains

the

base

class

that

all

JT

harness

interviews

must

implement:

com.sun.javatest.interview.

BasicInterviweParameters

BasicInterviewParameters.

com.sun.javatest.agent

The

classes

for

the

standard

JT

harness

agent

used

for

remote

execution

and

result

reporting.

Used

by

the

JCK

and

CDC

TCKs.

com.sun.javatest.servlets

A

few

utility

servlet

classes

provided

for

use

with

the

JT

harness.

Not

much

work

occurs

here.

com.sun.javatest.audit

Tool

for

auditing

test

results.

This

class

is

distributed

but

not

currently

in

active

use or development.