User's Manual

Chapter 2 Using the Signature Test Tool 23
▼ Running a Signature Test With the JavaTest
Harness
Although the SignatureTest command can be run by itself, SignatureTest can
also be executed as a test by the JavaTest harness. This section describes the items
that must be in place in a test suite to perform the signature test with the JavaTest
harness. If you are developing an API, it is advisable to provide a signature test
along with any behavioral tests you develope for that API. For information on how
to create a test suite see the JavaTest Architect's Guide available at:
http://java.sun.com/javame/reference/apis.jsp#javatest
Also see Appendix A for an example of running the SignatureTest command
from the command line without the JavaTest harness.
The following procedure describes how to add the signature test to your test suite
for use with the JavaTest harness.
1. Create the .sig file as described in “Setup Command” on page 14.
2. Create the following directory in your test suite and copy your .sig file to it:
test_suite-path/tests/api/signaturetest
Where test_suite
-path is the path to the base directory of the test suite installation.
3. Use the jar utility to extract the classes from sigtest.jar into the /classes
directory of your test suite, for example:
%cdtest_suite-path/tests/api/signaturetest/classes
% jar -xvf path/sigtest.jar
The sigtest.jar file contains the classes necessary to run the signature test
under the control of the JavaTest harness during a test run. You use the
sigtestdev.jar only for signature test development purposes.
4. Depending on which test description file you use, copy one of the test
description files provided in the SigTest tool distribution to the tests/
directory in your test suite.
The test description files are located in the following directory of the SigTest tool
installation along with the other sample signature test files:
SigTest-Directory/examples/sampleTCK/tck/tests/api/sigtest/
Open these files now in your favorite text editor to review their contents.
If you use the tag-based test description file, copy SignatureTest.java to the
following location, but if you use the HTML test description file, copy
SignatureTest.html to this location instead:
testsuite-path/tests/api/signaturetest/
Where
testsuite-path is the path to the base of the test suite installation.