Sun Microsystems 2 manual Case Sensitivity of Command Arguments, Signature File Formats

Page 30

Case Sensitivity of Command Arguments

The specification of each argument flag at the command line is not case sensitive, but the input value entered immediately after the argument flag is case sensitive.

The following two command lines produce identical results for the -FileNameflag:

%java com.sun.tdk.signaturetest.Setup -FileName name.sig

%java com.sun.tdk.signaturetest.Setup -filename name.sig

However, these two might not produce identical results if the host operating system is case sensitive to the file name values entered:

%java com.sun.tdk.signaturetest.Setup -FileName name.sig

%java com.sun.tdk.signaturetest.Setup -FileName NAME.sig

Signature File Formats

The SigTest tool has changed signature file formats through progressive versions. TABLE 2-3lists the existing signature file formats and describes how each relates to a specific SigTest tool version. In SigTest tool 1.5, the SignatureTest and Merge commands read v2.1 and later signature files, and output only v4.0. The v4.0 file format supports added functionality, such as generics and annotations.

TABLE 2-3Signature File Format Compatibility

Format

Description

 

 

v0

Generates a signature file with simple class member names. This was

 

the default format in SigTest tool 1.0, but is not supported by

 

SignatureTest command in SigTest tool 1.3 and later.

v1

Generates a signature file with fully qualified class member names.

 

This was the default format in SigTest tool 1.1. This format includes

 

non-normalizedexception throw lists for constructors and methods.

 

Normalizing the throw list involves removing all superfluous

 

exception classes. A class is superfluous if it is a subclass of either

 

the java.lang.RuntimeException class, or the

 

java.lang.Error class, or another class from the same list. This

 

format is not supported by SignatureTest command in SigTest

 

tool 1.3 and later.

v2

This is the default format for SigTest tool 1.2. Generates a signature

 

file with fully qualified class member names and modified supr

 

statements. This format includes normalized exception throw lists for

constructors and methods. This format is not supported by SignatureTest command in SigTest tool 1.3 and later.

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

Page 29 Page 31
Image 30
Page 29 Page 31
Contents SigTest Tool 2.0 User’s Guide Please Recycle Contents SignatureTest Command SetupAndTest CommandIndex Vi Signature Test Tool 2.0 User’s Guide April Tables Table A-1Viii Signature Test Tool 2.0 User’s Guide April Code Examples Signature Test Tool 2.0 User’s Guide April Who Should Use This Guide Before You Read This GuideHttp//jtharness.dev.java.net How This Guide Is Organized Related DocumentationTypographic Conventions Sun Welcomes Your CommentsXiv Signature Test Tool 2.0 User’s Guide April Introduction Signature Test BasicsWhat is Tested Mutual Binary Compatibility CheckMutual Source Compatibility Check Class and Class Member Attributes CheckedSource and Binary Compatibility Modes Using Custom Signature Loaders Signature Test Tool 2.0 User’s Guide April Using the Signature Test Tool Signature Test Tool BasicsReflection and Static Run Modes Generics Checking in Binary Mode Constant Checking in Differing Run ModesBootstrap and Extension Classes 1Settings for the Setup and SignatureTest CommandsPackage PackageWithoutSubpackages Exclude Merge Command Operative Principles Signature File Merge RulesJSR 68-Based Merge Element Handling by Merge Using the Signature Test Tool Java com.sun.tdk.signaturetest.Setup arguments Setup CommandCommand Description Help Debug Static Classpath pathPackage FileName filename ClosedFile File//pathNonClosedFile VerboseJava.lang.RuntimeException class, or Case Sensitivity of Command ArgumentsSignature File Formats 3Signature File Format CompatibilitySignature File Contents 4Signature File Content Summary Signature File BodyStrictfp Transient Volatile Synchroniz Native Help Debug Static Mode bin src 5SignatureTest Command ArgumentsJava com.sun.tdk.signaturetest.SignatureTest arguments ClassCacheSize sizeofcache CheckValueNoCheckValue Classpath see ClasspathErrorAll NoMergeFormatPlain Running a Signature Test With the JavaTest Harness SigTest-Directory/examples/sampleTCK/tck/tests/api/sigtestTestsuite-path/tests/api/signaturetest Report Formats Sorted ReportFileName ./name.sig Unsorted Report Code Example 2-1Unsorted Report ExampleJava com.sun.tdk.signaturetest.SetupAndTest arguments 6SetupAndTest Command ArgumentHelp Reference path Merge Command Java com.sun.tdk.signaturetest.Merge arguments7Merge Command Arguments Help Files Write -BinaryExample Setup Command Quick Start ExamplesRunning the Setup Command Javac -d V1.0 V1.0/test.javaV1.0/example/test.class This completes the Setup command example Example SignatureTest Command Running SignatureTest Without the JavaTest HarnessSTATUSFailed.3 errors Javac -d V2.0 V2.0/test.javaV2.0/example/test.class V2.0/example/test.class The API under test Example SetupAndTest CommandRunning the SetupAndTest Command Setenv JRE Java-Home/jre/lib/rt.jarCode Example A-5SetupAndTest Command Output Example Merge Examples Running Merge ExamplesA.class Run command #2 Example Result Files Code Example A-7 Contents of ./x2.sig Code Example A-9 Contents of x1+x2.sig Signature Test Tool 2.0 User’s Guide April Sorted report, 24 static mode IndexUnsorted report
Related manuals
Manual 50 pages 18.14 Kb

2 specifications

Sun Microsystems, founded in 1982, was a significant player in the computing industry, best known for its innovative technology solutions and workstations, particularly the Sun-4, which represented a key milestone in the company's history. The Sun-4 architecture, launched in 1987, utilized the SPARC (Scalable Processor Architecture) RISC processor, notable for its high performance and scalability.

One of the primary features of Sun Microsystems' platforms was their ability to efficiently handle multitasking and resource management, making them ideal for enterprise-level applications and development environments. Sun-4 workstations boasted impressive graphics capabilities with the addition of advanced graphical user interfaces, support for color displays, and the SUNVIEW windowing system, which enhanced user experience and productivity.

The Sun-4 systems also supported the SunOS operating system, which was based on UNIX. This operating system was engineered for stability and robustness, offering features like multiuser support, networked environments, and advanced security options. Moreover, SunOS provided seamless integration with various programming languages, including C and C++, facilitating software development that aligned with industry standards.

Another standout characteristic of Sun Microsystems was its commitment to open systems and standards. By providing developers with comprehensive tools and environments, such as the Standardized Application Programming Interface (API) and support for networking protocols, Sun facilitated interoperability among different computing platforms. The emphasis on open architecture also meant that customers could easily upgrade their systems without being locked into proprietary solutions.

Sun Microsystems was also ahead of its time with innovations in network computing. Their workstations were among the first to support network file systems and distributed computing concepts, enabling seamless data sharing across multiple systems. With the introduction of the Network File System (NFS), Sun revolutionized how data was accessed and managed across networks, which played a significant role in the evolving landscape of client-server computing.

In summary, the Sun Microsystems 2 and its successive innovations in workstation technology highlighted the company's forward-thinking approach. By integrating powerful performance with open systems, robust operating systems, and advanced networking capabilities, Sun laid the groundwork for modern computing, influencing various sectors from academia to enterprise solutions. Even after its acquisition by Oracle in 2010, the legacy of Sun Microsystems continues to be felt across the computing industry.
Top Page Image Contents