README

[Skip TOC]

Table of Contents

Introduction

Layout

Tutorial

Requirements

Run JT Harness

Changes Since JT Harness, Version 3.2

Usage Notes

Introduction

The JT harness is based on Sun Microsystem's JavaTest harness. The JT harness is a general purpose, fully-featured, flexible, and configurable test harness very well suited for most types of unit testing. Originally developed as a test harness to run TCK test suites, it has since evolved into a general purpose test platform.

The JT harness:

• Is designed to configure, sequence, and run test suites that consist of many (100,000 or more) discrete, independent tests. It is especially good at testing APIs and compilers.
• Can be used to run tests on all of the Java platforms, from the Java Card platform, to the Java Platform, Enterprise Edition ("Java EE").
• Enables you to create test suites that are self-contained products that customers can easily configure and run.

JT harness, Version 4.1.1 is a milestone release.  It is the first version that is fully open for contributed development.
Users are encouraged to try JT harness, participate in the community, and contribute to further development.

This binary release contains a built version of the JT harness (lib/javatest.jar) and a tutorial that introduces you to the JT harness graphical user interface.

[Top]

Layout

The JT harness binary distribution is laid out as follows:

install_dir/

legal/

Contains the licenses and Sun Microsystems copyrights that apply to this open source product.

lib/

Contains the JT harness binary (javatest.jar)and support libraries.

doc/

Contains documentation that accompanies the JT harness product.

examples/

tutorial/

Contains the JT harness tutorial (tutorial.html)

[Top]

Tutorial

1. Make examples/tutorial your current directory
2. Open tutorial.html in your web browser and follow the step-by-step directions

[Top]

Requirements

[Top]

Run JT Harness

Run the JT harness using the following command:

% java -jar javatest.jar

Note: Typically, a user executes JT harness in the context of a test suite. Read the tutorial documentation for instructions about how to execute JT harness with the tutorial example test suite.

[Top]

Changes Since JT Harness, Version 3.2

The JT harness, Version 4.1.1 release provided basic changes in the following areas:

• Upgraded template support using .jtm file extension
• Upgraded the reporting system including an XML report type
• Added a report converter tool to merge or convert XML reports
• Added the Current Template view filter
• Added a command-line option that can be used to write a configuration (.jti file)
• Added a command-line control for the filter used to generate reports
• Updated the rendering of some interview question types
• Added a log viewer system that enables the browsing of debugging and tracing information
• Added additional capabilities to the Folder Pane test lists (a context menu and a second column of information)
• The JavaHelp system library (jh.jar) has been added to the binary distribution lib/ directory. User's are no longer required to download the library separately.

Usage Notes

Run JavaTest harness, Version 4.1.1 with Java Platform, Standard Edition (Java SE) 5.0 or later.

Online Help Search Highlighting

The highlighting of search terms in the online help search results is sometimes incorrectly offset due to changes in Java SE after version 5.0_02.

Printing Pages from the Online Help and Test Reports

Because of the method the Java SE platform uses to render fonts, when you print a document from the JT harness user interface, the fonts in the printed documents are larger than they are when rendered on the screen.

The JT harness user's guides are provided in PDF format to make it easier for you to print. While the online help viewer supports printing operations, in some cases you may be unable to use it to print a specific page. If this occurs, use the PDF version.

Serial Communications on the Microsoft Windows Platorm

The Java Communications API used for serial communications does not currently support the Windows platform. Please see the Java Communications API web site for more information.

Changing Status Colors in the GUI

The JT harness allows the user to specify the status colors used in the GUI. See the online help for detailed information about changing the default status colors.

Agent Monitor Tool

The Agent Monitor tool may not apply to all test suites, even if the test suite uses an agent. See your test suite documentation for detailed information about the agent that it uses and its use of the Agent Monitor tool.

[Top]

Copyright © 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. The majority of JT Harness project is released under the GNU General Public License Version 2 (GPLv2). Special Assembly Exception terms allow licensees to build an executable that includes portions of necessary code that Sun could not provide under GPL2.