Preface

This manual is intended for test suite architects who design JavaTest harness test suites. It assumes that you are familiar with the Java programming language and with running Java programs on at least one platform implementation.

Before You Read This Book

It is highly recommended that you read the JavaTest online help, the Test Suite Developer's Guide, and TCK Project Planning and Development Guide, which are available as part of the Java Compatibility Test Tools release. Note that for convenience, the JavaTest online help is also available in PDF format.

This guide is divided into the following chapters and appendices:

	Chapter 1	Introduction
Part I	The Basics
	Chapter 2	A tutorial that introduces the JavaTest GUI.
	Chapter 3	Describes the test suite components for which architects are responsible.
	Chapter 4	Leads you through the process of creating a small working test suite.
	Chapter 5	Describes how to write tests that work well with name="ProductName" content="JavaTest Harness"?>.
	Chapter 6	Describes how to create configuration interviews for test suites.
Part II	Advanced Topics
	Chapter 7	Describes how to use the name="ProductName" content="JavaTest Harness"?> to compile test suites.
	Chapter 8	Describes how test finders work and how to create a customized version for your test suite.
	Chapter 9	Describes how test scripts work and how to create a customized version for your test suite.
	Chapter 10	Describes how the test suite object works and how to create a customized version for your test suite.
	Chapter 11	Describes the ServiceManager component provided by name="ProductName" content="JavaTest Harness"?> and how test suite architects can use it to manage services.
	Chapter 12	Describes how to retrofit existing JUnit 3.x or 4.x test suites to enable them to run with the name="ProductName" content="JavaTest Harness"?> harness.
	Chapter 13	Describes customizations that test suite architects can make in the name="ProductName" content="JavaTest Harness"?> harness.
	Appendix A	Describes the standard commands available from the JavaTest command library.
	Appendix B	Describes the file formats and specifications used by name="ProductName" content="JavaTest Harness"?>.
	Appendix C	Tips for writing interviews.
Glossary		Defines terms used in this book and other TCK documentation.

Typographic Conventions

Typeface Meaning Examples

Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized Command-line variable; replace with a real name or value	Read Chapter 6 in the User's Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` filename.

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your .login file.

Use ls -a to list all files.

AaBbCc123

What you type, when contrasted with on-screen computer output

% su

Password:

AaBbCc123

Book titles, new words or terms, words to be emphasized

Command-line variable; replace with a real name or value

Read Chapter 6 in the User's Guide.

These are called class options.

You must be superuser to do this.

To delete a file, type rm filename.

Shell Prompts

Shell	Prompt
Bourne shell and Korn shell	`%`
MSDOS	C:\>

Technology	Title
JavaTest harness	JavaTest online help (available both online and in PDF format)
TCK development process	TCK Project Planning and Development Guide
Java Compatibility Test Tools	Test Suite Developer's Guide

Accessing Java Platform Documentation Online

The Java Developer Connectionsm web site enables you to access Java platform technical documentation on the Web:

http://download.oracle.com/javame/testing.html

Oracle Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:

appserverdocs_us@oracle.com