Sun Microsystems 2 Example SetupAndTest Command

34 Signature Test Tool 2.0 User’s Guide • April 2008

Example SetupAndTest Command

The following procedure runs the SetupAndTest command to create a new

test2.sig file from the input API class, and compare it with the specified

example package.

▼Running the SetupAndTest Command

Thisprocedure assumes the same current working directory as the previous example

in “RunningSignatureTest Without the JavaTest Harness” on page 32, and the same

environmentsetup. It uses these files from previous examples:

■./V1.0/example/test.class - The API class used as the reference

■./V2.0/example/test.class - The API under test

1. Set the JRE environment variable for access to the Java runtime environment

files.

The SetupAndTest command running in static mode must have access to all

superclassesand superinterfaces of any public classes that are under test, such as

java.lang.Object.

% setenv JRE Java-Home/jre/lib/rt.jar

Where Java-Home is the base directory of the Java runtime environment

installation.

2. Run the following SetupAndTest command:

Added Methods

-------------

example.test: method public java.lang.String example.test.get(int)

example.test: method public void example.test.put()

STATUS:Failed.3 errors

CODEEXAMPLE A-4 The report.txt File

Contents

Main Please Recycle Contents Page Page Page Tables Page Code Examples Page Preface Note Who Should Use This Guide Before YouRead This Guide How This Guide Is Organized Related Documentation Typographic Conventions Sun Welcomes Your Comments Page Introduction Signature TestBasics Note What is Tested Mutual Binary Compatibility Check Mutual Source Compatibility Check Class and Class Member Attributes Checked Source and Binary Compatibility Modes Using Custom Signature Loaders Note Using the Signature Test Tool Signature TestTool Basics Reflection and Static Run Modes Note Constant Checking in Differing Run Modes Generics Checking in Binary Mode CLASSPATH and -classpath Settings Bootstrap and Extension Classes Signature File Merge Rules JSR 68-Based Merge Merge Command Operative Principles Element Handling by Merge Page Setup Command Page Case Sensitivity of Command Arguments Signature File Formats Signature File Contents Note Signature File Header Signature File Body Note Page SignatureTest Command Note Page Page Running a Signature Test With the JavaTest Harness Report Formats Sorted Report Unsorted Report SetupAndTest Command Merge Command Page Quick Start Examples Note Example Setup Command Note Running the Setup Command Note example in Running SignatureTest Withoutthe JavaTest Harness on page 32. Example SignatureTest Command Running SignatureTest Without the JavaTest Harness Note Example SetupAndTest Command Running the SetupAndTest Command Page Merge Examples Running Merge Examples Page Page Example Result Files Page Page Page Index C G J M