sun.com docs.sun.com My Sun Worldwide Sites
Technology Compatibility Kit User's Guide for Java API for XML Web Services (JAX-WS) 2.2

For Technology Licensees

September 2009
The Technology Compatibility Kit User's Guide for the Java API for XML Web Services 2.2 provides detailed instructions for obtaining, installing, configuring, and using the Java API for XML Web Services TCK.
--

Document Information

Preface

1.  Introduction

1.1 Compatibility Testing

1.1.1 Why Compatibility Testing is Important

1.1.2 TCK Compatibility Rules

1.1.3 TCK Overview

1.1.4 Java Community Process (JCP) Program and Compatibility Testing

1.2 About the JAX-WS TCK 2.2

1.2.1 JAX-WS TCK Specifications and Requirements

1.2.2 JAX-WS TCK Components

1.2.3 JavaTest Harness

1.2.4 TCK Compatibility Test Suite

1.2.5 Exclude Lists

1.2.6 JAX-WS TCK Configuration

1.3 Getting Started With the JAX-WS TCK

To get started with the JAX-WS TCK

2.  Procedure for Java API for XML Web Services 2.2 Certification

2.1 Certification Overview

2.2 Compatibility Requirements

2.2.1 Definitions

2.2.2 Rules for Java API for XML Web Services 2.2 Products

2.2.3 Java API for XML Web Services 2.2 Test Appeals Process

Java API for XML Web Services TCK Test Appeals Steps

2.2.3.1 Test Challenge Form

2.2.3.2 Test Challenge Response Form

2.3 Reference Runtime for Java API for XML Web Services 2.2

2.4 Specifications for Java API for XML Web Services 2.2

2.5 Libraries for Java API for XML Web Services 2.2

3.  Installation

3.1 Obtaining the JAX-WS 2.2 Reference Implementation

3.2 Installing the Software

To install the JAX-WS software

4.  Setup and Configuration

4.1 Configuring Your Environment to Run the JAX-WS TCK Against the Sun Reference Implementation

To Configure Your Environment to Run the JAX-WS TCK Against the Sun RI

4.2 Configuring Your Environment to Run the JAX-WS TCK Against the Vendor Implementation

To Configure Your Environment to Run the JAX-WS TCK Against the VI

4.3 Configuring Your Environment to Rebuild and Run the JAX-WS TCK Against the Sun RI

To Configure Your Environment to Rebuild and Run Against the Sun RI

4.4 Configuring Your Environment to Simultaneously Run the JAX-WS TCK Against the VI and the Sun RI

4.5 Configuring and Starting Your Application Server(s)

To Configure the Vendor implementation as your VI environment

To Configure the Sun Reference implementation as your RI environment

4.6 Deploying the JAX-WS TCK Tests

4.6.1 Generic Deployment Command Scenarios

To Deploy all the WAR Files From the <TS_HOME>/dist to Both Web Servers

To Deploy a Single Test Directory in the Forward Direction

To Deploy a Subset of Test Directories in the Reverse Direction

4.6.2 Deploying the JAX-WS TCK Prebuilt Archives

4.6.3 Deploying the Rebuilt JAX-WS TCK Tests Against the Sun Reference Implementation

4.7 Using the JavaTest Harness Software

4.8 Using the JavaTest Harness Configuration GUI

4.8.1 Configuration GUI Overview

4.8.2 Starting the Configuration GUI

4.8.3 The Configuration Interview

To configure the JavaTest harness to run the JAX-WS TCK tests

4.8.4 Modifying the Default Test Configuration

5.  Executing Tests

5.1 Overview

5.2 Starting JavaTest

To Start JavaTest in GUI Mode

To Start JavaTest in Command-Line Mode

5.3 Running a Subset of the Tests

To Run a Subset of Tests in GUI Mode

To Run a Subset of Tests in Command-Line Mode

To Run a Subset of Tests in Batch Mode Based on Prior Result Status

5.4 Running the JAX-WS TCK against the Sun RI

To Run the JAX-WS TCK Against the Sun RI

5.5 Running the JAX-WS TCK Against a Vendor's Implementation

To Run the JAX-WS TCK Against a VI

5.6 Running the Rebuilt JAX-WS TCK Against the Sun RI

To Run the Rebuilt JAX-WS TCK Against the Sun RI

5.7 Testing Interoperability Between a Vendor Implementation and the Sun Reference Implementation

To Test Interoperability Between a VI and the Sun RI

5.8 Test Reports

5.8.1 Creating Test Reports

To Create a Test Report in GUI Mode

To Create a Test Report in Command-Line Mode

5.8.2 Viewing an Existing Test Report

To View an Existing Report in GUI Mode

To View an Existing Report in Command-Line Mode

6.  Debugging Test Problems

6.1 Overview

6.2 Test Tree

6.3 Folder Information

6.4 Test Information

6.5 Report Files

6.6 Configuration Failures

A.  Frequently Asked Questions

A.1 Where do I start to debug a test failure?

A.2 How do I restart a crashed test run?

A.3 What would cause tests be added to the exclude list?

B.  Rebuilding the JAX-WS TCK Using the Vendor's Toolset

B.1 Overview

B.2 Rebuilding the JAX-WS TCK Classes Using Ant

To Rebuild the JAX-WS TCK Classes Using Ant

B.3 Rebuilding the JAX-WS TCK Classes Manually

To Rebuild the JAX-WS TCK Classes Manually

B.4 wsgen Reference

B.4.1 wsgen Syntax

B.4.2 wsgen Ant Task

B.4.3 wsgen Example

B.5 wsimport Reference

B.5.1 wsimport Syntax

B.5.2 wsimport Ant Task

B.5.3 wsimport Examples

Company Info Contact Terms of Use Privacy Copyright 1994-2009 Sun Microsystems, Inc.