<!-- Fragment document type declaration subset:
Arbortext, Inc., 1988-2008, v.4002
<!DOCTYPE SOLBOOK PUBLIC "-//Sun Microsystems//DTD SolBook 3.1//EN" [
<!ENTITY % TCKentities SYSTEM "TCKentities.ent">
%TCKentities;
<!ENTITY typeconv SYSTEM "typeconv.sgm">
]>
-->
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<preface id="GBFTI"><title>Preface</title>
<highlights>
<para>This guide describes how to install, configure, and run the Technology
Compatibility Kit (TCK) that is used to test the &TechnologyFullName; (&TechnologyShortName; &TechnologyVersion;)
(&JSR;) technology.</para>
<para>The &TCKShortName; is designed as a portable, configurable automated
test suite for verifying the compatibility of a licensee's implementation
of the &TechnologyShortName; &TechnologyVersion; Specification (hereafter
referred to as the licensee implementation). The &TCKShortName; uses the JavaTest
harness version &JavaTestVersion; to run the test suite</para>
<note><para>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.</para></note>
<para>Refer to the &JavaPartnerURL; Web site for answers to frequently asked
questions and send questions you may have to your Java Partner Engineering
contact.</para></highlights>
<sect1 id="GBFUS"><?Pub Dtl><title>Who Should Use This Book</title>
<para>This guide is for licensees of Sun Microsystems's &TechnologyShortName; &TechnologyVersion; technology
to assist them in running the test suite that verifies compatibility of their
implementation of the &TechnologyShortName; &TechnologyVersion; Specification.</para>
</sect1>
<sect1 id="GBFPO"><?Pub Dtl><title>Before You Read This Book</title>
<para>Before reading this guide, you should familiarize yourself with the
Java programming language and the &TechnologyShortName; &TechnologyVersion; Specification.
A good resource for the Java Programming language is the <ulink
url="http://java.sun.com" type="text_url">Sun Microsystems, Inc.</ulink> Web
site.</para>
<para>Sun Microsystems recommends that before you run the tests in the &TCKShortName; you
have read and are familiar with the &TechnologyShortName; &TechnologyVersion; Specification
and the JavaTest User's Guide, which describes the main JavaTest harness.
The JavaTest User's Guide is located at <varname>&lt;install_dir></varname><filename>
/docs/javatest/javatest.pdf</filename> in the &TCKShortName; distribution.</para>
</sect1>
<sect1 id="GBFQI"><title>How This Book is Organized</title>
<para>If you are installing and using the &TCKShortName; for the first time,
it is recommended that you read <olink targetptr="GBFOW">Chapter&nbsp;1, Introduction
</olink> and <olink targetptr="GBFSN">Chapter&nbsp;2, Procedure for Java API
for RESTful Web Services 1.0 Certification</olink> completely for the necessary
background information, and then perform the steps outlined in the remaining
chapters, while referring to the appendixes as necessary.</para>
<itemizedlist>
<listitem><para><olink targetptr="GBFOW">Chapter&nbsp;1, Introduction</olink> gives
an overview of the principles that apply generally to all Technology Compatibility
Kits (TCKs) and describes the &TCKShortName;. It also includes a listing of
the basic steps needed to get up and running with the &TCKShortName;.</para>
</listitem>
<listitem><para><olink targetptr="GBFSN">Chapter&nbsp;2, Procedure for Java
API for RESTful Web Services 1.0 Certification</olink> describes the conformance
testing procedure and testing requirements.</para></listitem>
<listitem><para><olink targetptr="GBFTP">Chapter&nbsp;3, Installation</olink> explains
how to install the &TCKShortName;.</para></listitem>
<listitem><para><olink targetptr="GBFVV">Chapter&nbsp;4, Setup and Configuration</olink> describes
how to set up the &TCKShortName; and how to start and configure the JavaTest
harness software to be used with the &TCKShortName;.</para></listitem>
<listitem><para><olink targetptr="GBFWO">Chapter&nbsp;5, Executing Tests</olink> describes
how to start the JavaTest harness and use the &TCKShortName;.</para></listitem>
<listitem><para><olink targetptr="GBFUV">Chapter&nbsp;6, Debugging Test Problems</olink> describes
several approaches for dealing with tests that fail to execute properly.</para>
</listitem>
<listitem><para><olink targetptr="GBFYD">Appendix&nbsp;A, Frequently Asked
Questions</olink> provides answers to frequently asked questions.</para>
</listitem>
</itemizedlist><?Pub Caret1>
</sect1>&typeconv;
&TCKdocs;
</preface>
<?Pub *0000004658 0>
