README for JETpack - the Java Enabled TETware Package

JETPack is an implementation of a Java Language Binding for TET3 (3.1->3.3). 
This document describes the high level implementation philosophy for JETpack. 
For further documentation on using JETpack, see the doc/ directory. For
information on building and installing JETpack, see the file INSTALL. For an
example of tests implemented using JETPack, see the jdemo/ directory.

JETpack is implemented as a Java binding that relies upon the TET API
libraries. These libraries are bound to the executing Java Byte Code engine
using the Java Native Interface - the JavaSoft standard method for accessing
native code from a Java application.

The philosophy of this interface is that the Java application should drive the
test. This is somewhat at odds with the general TET philosophy that the TET
test case manager should be the "main" for the test case. However, we felt
that the Java community would be more likely to embrace a test scaffold that
was implemented from the Java perspective.

This does not mean that user-provided code is needed to drive the tests. On
the contrary, the test drivers are much as they are in TET's C and C++
language bindings. Users write test routines as methods of a test class, and
the test driver calls these test routines after establishing the appropriate
protected environment. However, the entry point for the test is a
user-provided main() in the user's class under test. This main() needs to
instantiate the TET test class and call the TET test driver. This means that
the user can perform any needed setup or cleanup code around the call to the
TET test driver.

For more information about TET, see the
TET web site at http://tetworks.opengroup.org/