Sun Microsystems 2 Unsorted Report

Chapter 2 Using the Signature Test Tool 25

■Missing Classes

■Missing Class Descriptions (Modified classes and nested classes)

■Missing Superclasses or Superinterfaces

■Missing Fields

■Missing Constructors

■Missing Methods

■Added Classes

■Added Class Descriptions (Modified classes and nested classes)

■Added Superclasses or Superinterfaces

■Added Fields

■Added Constructors

■Added Methods

■Linkage Errors

Linkage errors occur during testing if the API implementation under test is

corrupted, for example, if a superclass or superinterface of a class under test cannot

be loaded.

See the sorted report in CODEEXAMPLE A-4.

Unsorted Report

The -FormatPlain option specifies an unsorted report. The unsorted format

reports messages immediately during execution and duplicate messages are

included.

CODEEXAMPLE 2-1 shows an unsorted report that correspondsto the sorted report in

CODEEXAMPLE A-4.

CODEEXAMPLE 2-1 UnsortedReport Example

Definition required but not found in example.test

method public int get(int)

Definition found but not permitted in example.test

method public java.lang.String get(int)

Definition found but not permitted in example.test

method public void put()

SignatureTest report

Tested version: 2.0

STATUS: Failed. 3 errors

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