sun.com docs.sun.com My Sun Worldwide Sites

     Contents     Next Next

Technology Compatibility Kit User's Guide for SOAP with Attachments API for Java 1.3

For Technology Licensees

Preface

This guide describes how to install, configure, and run the Technology Compatibility Kit (TCK) that is used to test the Common SOAP with Attachments API for Java 1.3 (SAAJ 1.3) technology.

The SAAJ TCK is designed as a portable, configurable automated test suite for verifying the compatibility of a licensee's implementation of the SAAJ 1.3 Specification (hereafter referred to as the licensee implementation). The SAAJ TCK uses the JavaTest harness version 3.2.1 to run the test suite


Note - Note All references to specific Web URLs are given for the sake of your convenience in locating the resources quickly. These references are always subject to changes that are in many cases beyond the control of the authors of this guide.


Refer to the Java Partner Engineering Web site for answers to frequently asked questions and send questions you may have to your Java Partner Engineering contact.

Who Should Use This Book

This guide is for licensees of Sun Microsystems's SAAJ 1.3 technology to assist them in running the test suite that verifies compatibility of their implementation of the SAAJ 1.3 Specification.

Before You Read This Book

Before reading this guide, you should familiarize yourself with the Java programming language and the SAAJ 1.3 Specification. A good resource for the Java Programming language is the Sun Microsystems, Inc. Web site.

The SOAP with Attachments API for Java 1.3 is based on the SAAJ Specification 1.3. Links to the specification and other product information can be found on the Web at http://jcp.org/aboutJava/communityprocess/maintenance/jsr067/index2.html. Sun Microsystems recommends that before you run the tests in the SAAJ TCK you have read and are familiar with the SAAJ 1.3 Specification and the JavaTest User's Guide, which describes the main JavaTest harness. The JavaTest User's Guide is located at <install_dir>/docs/javatest/javatest.pdf in the SAAJ TCK distribution.

How This Book is Organized

If you are installing and using the SAAJ TCK for the first time, it is recommended that you read Chapter 1 and Chapter 2 completely for the necessary background information, and then perform the steps outlined in the remaining chapters, while referring to the appendix as necessary.

  • Chapter 1 gives an overview of the principles that apply generally to all Technology Compatibility Kits (TCKs) and describes the SAAJ TCK. It also includes a listing of the basic steps needed to get up and running with the SAAJ TCK.

  • Chapter 2 describes the conformance testing procedure and testing requirements.

  • Chapter 3 explains how to install the SAAJ TCK.

  • Chapter 4 describes how to set up the SAAJ TCK and how to start and configure the JavaTest harness software to be used with the SAAJ TCK.

  • Chapter 5 describes how to start the JavaTest harness and use the SAAJ TCK.

  • Chapter 6 describes several approaches for dealing with tests that fail to execute properly.

  • Appendix A provides answers to frequently asked questions.

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P-1 Typographic Conventions

Typeface

Meaning

Example

AaBbCc123

The names of commands, files, and directories, and onscreen computer output

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.

AaBbCc123

What you type, contrasted with onscreen computer output

machine_name% su

Password:

aabbcc123

Placeholder: replace with a real name or value

The command to remove a file is rm filename.

AaBbCc123

Book titles, new terms, and terms to be emphasized

Read Chapter 6 in the User's Guide.

A cache is a copy that is stored locally.

Do not save the file.

Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell

Prompt

C shell

machine_name%

C shell for superuser

machine_name#

Bourne shell and Korn shell

$

Bourne shell and Korn shell for superuser

#

Related Documentation

Table P-3 Related Documentation Titles

Application

Title

Using JavaTest software

JavaTest User's Guide and JavaTest online help (located in the TS_HOME/docs directory in the SAAJ TCK distribution)

SAAJ reference

The SOAP with Attachments API for Java 1.3 Specification

Using Java technology

Java Programming Language, Java Language Specification Second Edition, Java Virtual Machine Specification Second Edition, Java 2 Platform

Accessing Sun Documentation Online

The Java Developer ConnectionSM Web site enables you to access Java platform technical documentation.

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at mailto:docs@java.sun.com.

     Contents     Next Next
Company Info Contact Terms of Use Privacy Copyright 1994-2006 Sun Microsystems, Inc.