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

For Technology Licensees

December 2009
The Technology Compatibility Kit User's Guide for the Java API for RESTful Web Services provides detailed instructions for obtaining, installing, configuring, and using the Java API for RESTful Web Services 1.1 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-RS 1.1 TCK 1.1

1.2.1 JAX-RS 1.1 TCK Specifications and Requirements

1.2.2 JAX-RS 1.1 TCK Components

1.2.3 JavaTest Harness

1.2.4 TCK Compatibility Test Suite

1.2.5 Exclude Lists

1.2.6 JAX-RS 1.1 TCK Configuration

1.3 Getting Started With the JAX-RS 1.1 TCK

To Get Started With the JAX-RS 1.1 TCK

2.  Procedure for Java API for RESTful Web Services Certification

2.1 Certification Overview

2.2 Compatibility Requirements

2.2.1 Definitions

2.2.2 Rules for Java API for RESTful Web Services Products

2.3 Java API for RESTful Web Services 1.1 Test Appeals Process

Java API for RESTful Web Services 1.1 TCK Test Appeals Steps

2.4 Reference Runtime for Java API for RESTful Web Services 1.1

2.5 Specifications for Java API for RESTful Web Services 1.1

2.6 Libraries for Java API for RESTful Web Services 1.1

3.  Installation

3.1 Obtaining the JAX-RS 1.1 Reference Implementation (Jersey 1.1)

3.2 Installing the Software

To Install the JAX-RS 1.1 TCK Software

4.  Setup and Configuration

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

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

4.2 Configuring Your Environment to Repackage and Run the JAX-RS 1.1 TCK Against the Vendor Implementation

To Configure Your Environment to Repackage and Run the JAX-RS 1.1 TCK Against the Vendor Implementation

4.3 Publishing the JAX-RS 1.1 TCK Test Applications

4.3.1 Generic Deployment Command Scenarios

To Deploy all the WAR Files From the <TS_HOME>/dist to a Web Server

To Deploy a Single Test Directory

To Deploy a Subset of Test Directories

4.3.2 Deploying the JAX-RS 1.1 TCK Prebuilt Archives

4.3.3 Deploying the JAX-RS 1.1 TCK Test Applications Against the Vendor Implementation

4.4 Using the JavaTest Harness Software

4.5 Using the JavaTest Harness Configuration GUI

4.5.1 Configuration GUI Overview

4.5.2 Starting the Configuration GUI

4.5.3 The Configuration Interview

To Configure the JavaTest Harness to Run the JAX-RS 1.1 TCK Tests

4.5.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-RS 1.1 TCK against the Sun RI

To Run the JAX-RS 1.1 TCK Against the Sun RI

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

To Run the JAX-RS 1.1 TCK Against a VI

5.6 Test Reports

5.6.1 Creating Test Reports

To Create a Test Report in GUI Mode

To Create a Test Report in Command-Line Mode

5.6.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.  Packaging the JAX-RS 1.1 TCK Test Applications in Servlet-Compliant WAR Files With VI-Specific Information

B.1 Overview

B.2 Creating the JAX-RS 1.1 TCK VI-Specific Servlet-Compliant WAR Files

To Create a VI-Specific Deployment Descriptor

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