Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Before You Read This Book

1 Introduction

• Installation and Runtime Security Guidelines
• Examples

Part I The Basics

2 JavaTest Tutorial

• Overview
• Running the Tutorial
  • Start the JavaTest Harness
  • Run the Quick Start Wizard
  • Configure Test Information
  • Run Tests
  • Browse the Results
    • The Folder Pane
    • The Test Pane
  • Exclude the Failed Test
  • Generate a Report
• Summary

3 Overview

• Test Suite Components
• Remote Execution

4 Creating a Test Suite

• Create a Test Suite
  • Create a Test Suite Directory
  • Create the testsuite.jtt File
  • Copy javatest.jar
  • Set Up the classes Directory
  • Use a Simple Test Template
  • Create and Compile a Simple Test Example
  • Run a Test Suite
• Odds and Ends
  • Top-Level Test Suite Directory
  • The Test Suite JAR File
  • Class Paths
    • JavaTest Class Path
    • Agent Class Path
    • Test Class Path

5 Writing Tests

• The Test Execution Model
• The Test Interface
  • Class Paths
• Test Status
• Test Description Entries
  • Keywords
• Multiple Tests in a Single Test File
  • Subtyping MultiTest
• Organizing Tests Within Your Test Suite
  • Source Files
  • Class Files
• Error Messages

6 Creating a Configuration Interview

• Designing Your Configuration
  • What is a Configuration?
    • Test Script Information
    • Test Description Entries
    • Which Tests to Run
• Designing Your Interview
  • Command Strings
    • Example 1
    • Example 2
  • Test Environment Variables
• Writing Your Interview
  • Demo TCK interview
  • Demo Interview
    • Start the Demo Interview
  • Interview Classes
  • The Current Interview Path
  • Determining the Next Question
  • Error Checking
  • Exporting the Test Environment
  • Question Types
    • Designing Your Questions
    • Landing Point Questions
    • Sub-Interviews
  • Putting it All Together
    • Providing the Prolog
    • Providing the Environment Group
    • Providing the Resource File for the Interview
    • Providing the More Info Help for the Interview
• Creating Question Text and More Info
  • Writing Style
  • Creating Question Text and Keys
  • Creating More Info
    • Set Up the More Info System
    • Create HTML Topics for All Interview Questions
    • Customizing Standard Question More Info
• Creating the JAR File

Part II Advanced Topics

7 Compiling Test Suites

• System Properties

8 The TestSuite Object

• The testsuite.jtt File
• Overriding Default Methods

9 Test Finder

• Test Finder Subtypes
  • Tag Test Finder
  • HTML Test Finder
  • Binary Test Finder
    • BinaryTestWriter
    • BinaryTestFinder

10 Test Scripts

• Design Decisions
  • Simple Test Scripts
  • More Flexible Test Scripts
    • Example 1
    • Example 2
• Writing Custom Commands
• Test Result

11 Service Management

• Description
• Services-Related Work Flow
• Implementation
  • Implementations of ServiceReader Interface
    • PropertyServiceReader File Format
    • XMLServiceReader File Format
  • Implementation of Service Interface
  • Service Properties
• Service Management Architecture
  • Mechanism to Instantiate Service, Connector, and ServiceExecutor Interfaces
  • Separate Services Start Up

12 Running JUnit Tests

• The Retrofit Process
  • Prerequisites for Converting Tests
    • Procedure for Converting Tests
• Technical Details
  • Support Classes
    • JUnitSuperTestFinder
    • JUnitAnnotationTestFinder
    • JUnitBareMultiTest
    • JUnitAnnotationMultiTest
  • Implementation Notes
• Areas for Improvement
  • References

13 Customization

• Customization API
• Internationalization
• Customizing the Splash Screen
  • Example of splash.properties File
  • Notes About the Implementation
• Customizing Menus
  • Adding Menu Items to Test Manager Menus
  • Adding Menu Items to the Tree Popup Menu
• Customizing Toolbars

A Standard Commands

• ActiveAgentCommand
• ExecStdTestSameJVMCmd
• ExecStdTestOtherJVMCmd
• JavaCompileCommand
• PassiveAgentCommand
• ProcessCommand
• SerialAgentCommand

B Formats and Specifications

• Test URL Specification
  • Test Paths
• Exclude List File Format
  • Syntax
    • Test URL and Test Cases
    • BugIDs
    • Keywords
    • Synopsis
    • Comments and Header Information

C What Technical Writers Should Know About Configuration Interviews

• Question Text
• More Info
  • Formatting Styles
  • Usage and Conventions

Glossary

Index