# Java(TM) API for RESTful Web Services Technology Compatibility Kit, Version 1.1
Release Notes, November 2010

## Release Notes Update For Jersey 1.4 RI Release November 2010

A couple of changes made in Jersey 1.4 RI prompts this note.

- The Jersey 1.4 release requires the use of Java SE 6 and this is also required when running the JAX-RS TCK against Jersey 1.4.

- In Jersey 1.4, JAX-RS API class files are bundled into jersey-core.jar, jsr311-api.jar no longer exists standalone. Modification will be needed accordingly in $TS_HOME/bin/ts.jte to run the TCK with Jersey.

  Namely, if you used to use
  jaxrs.classes=${jersey.home}/lib/jsr311-api.jar
  Now use
  jaxrs.classes=${jersey.home}/lib/jersey-core.jar

## Kit Contents

The JAX-RS 1.1 Technology Compatibility Kit (TCK) includes the following items:

- JavaTest harness and documentation

  - The JavaTest harness Release Notes are provided in the JavaTest documentation bundle.

  - The JavaTest harness provides three user guides in PDF format. The JavaTest User's Guides are also available in JavaHelp format, and can be displayed either in the JavaTest harness or in a separate viewer launched from the command line.

    - JavaTest User's Guide: Graphical User Interface contains information on using the test harness GUI.
    - JavaTest User's Guide: Command Line Interface contains information on running tests by using the test harness command line.
    - JavaTest Agent User's Guide contains information on running tests by using the test harness agent.

- JAX-RS TCK signature, API and specification tests:

  - A signature test that checks that all of the public APIs are supported or defined in the JAX-RS 1.1 implementation that is under test.

  - Specification tests for the testable assertions required by the JAX-RS 1.1 Specification.

  - API tests for the public APIs and language elements defined by the JAX-RS 1.1 Specification.

## Platform Notes

The JAX-RS 1.1 TCK tests and the JAX-RS 1.1 Reference Implementation (RI) can be run with Java Platform, Standard Edition version 5.0 (Java SE 5) or above. See Reference Runtime for JAX-RS 1.1 for additional information.

Refer to the Technology Compatibility Kit User's Guide for Java™ API for RESTful Web Services for platform compatibility requirements and notes.

## Reference Runtime for JAX-RS 1.1

The designated Reference Runtime for compatibility testing of implementations based upon the JAX-RS 1.1 Specification is as follows:

- Java SE 6, which must be used with a Java EE 6 profile/application server, such as the GlassFish v3 server

- Sun Reference Implementation (RI) of JAX-RS 1.1 available as a standalone implementation from Java Licensee Engineering or included as part of the Java EE 6 RI or the Java EE 6 Web Profile RI, both of which are also available from Java Licensee Engineering

- The JAX-RS 1.1 TCK tests can be run on the following platforms:

  - Solaris 9 Operating System on Sparc and x86
  - Solaris 10 Operating System on Sparc and Opteron
  - Windows XP Professional Edition
  - Windows Vista
  - RedHat Linux 9.0
  - RedHat Linux AS 3.0 (including Update 4)
  - MacOS X 10.5.7g

## Installing, Setting Up, and Running the JAX-RS 1.1 TCK

Refer to the Technology Compatibility Kit User;s Guide for Java™ API for RESTful Web Services 1.1, included in the documentation bundle (a separate download from the product bundle), for complete instructions on installing, setting up, and running the JAX-RS 1.1 TCK.

## Last Minute Correction from User's Guide

- Correction to "Appendix B. Packaging the JAX-RS 1.1 TCK Test Applications in Servlet-Compliant WAR Files With VI-Specific Information"

  There are a few places mention that prebuilt test WAR files for deployment on Java EE 6 RI are named jaxrs_rs_getTest.jersey_web.war. They are actually named jaxrs_rs_getTest_web.war.jersey. Also for VI-Specific Servlet–compliant war files, they should be named jaxrs_rs_getTest_web.war.${jaxrs_impl_name}. The reason behind this is that the deploy action will not try to deploy all war files, only the war files that match implementation name ${jaxrs_impl_name}.

## Attributions

The JAX-RS 1.1 TCK includes software developed by the Apache Software Foundation (http://www.apache.org/). The Apache Ant Contrib project is located at http://ant-contrib.sourceforge.net/.