Lib Directory, Tests Directory | Sun Microsystems 1.2 manual

The testsuite.jtt file is located under the root directory of the Simple Test Suite. You can also find it under the build/ directory of the Simple Test Suite source.

lib Directory

The lib directory usually contains the javatest.jar file that provides all of the classes required to execute the harness, all of the JAR files under the lib directory of the Java ME TCK Framework, and the library classes. The test suite developer can use the library classes to simplify the creation of tests. With javatest.jar in the lib directory, the harness automatically locates the test suite and does not prompt the user for the path to test suite directory.

This directory also contains additional resource files required by the test suite. These files might include the following:

■testsuite.jar - If a custom interview or if customized harness plug-in classes are used, package the classes and interview files in a customtestsuite.jar file and place it in the lib directory.

In the Simple Test Suite example, this file is named sample_jt.jar and located under the SimpleTestSuite/lib directory.

■testsuite.jtx - The exclude list (testsuite.jtx)file identifies the tests in a test suite that are not required to be run.

Tests are not excluded in the Simple Test Suite, so it does not contain a testsuite.jtx file.

The exclude list file usually has the following format: Test-URL[Test-Cases] BugID Keyword

The following is an example of two lines from an exclude list file.

api/java_awt/EventQueue/index.html#Invoke[EventQueue2006] 6406330 test api/java_awt/Adjustable/index.html#SetGetValue 4682598 spec_jdk

tests Directory

The tests directory contains test sources and test descriptions grouped by the test developer according to a specific design principle. Tests might be grouped in a test directory in the following cases:

■All tests that examine the same component or functionality

■All tests that have a configuration in common

Chapter 3 Test Suite Construction 25

Image 45

Sun Microsystems 1.2 manual Lib Directory, Tests Directory

Contents

Java ME TCK Framework Developers Guide Test suite developer’s guide for the Java ME TCK Framework Contents Writing Tests Test Suite Construction Remote Attribute Framework Bundle 81 lib Directory Test API Glossary Index Test Description Fields and Keywords Viii Java ME TCK Framework Developer’s Guide July Figures Java ME TCK Framework Developer’s Guide July Tables Xii Java ME TCK Framework Developer’s Guide July Code Examples Resources Attribute in the Test Description Before You Read This Book Preface How This Book Is Organized Intended Audience Examples Platform Commands Related Documentation Typographic Conventions Sun Welcomes Your Comments Accessing Sun Documentation Online Xx Java ME TCK Framework Developer’s Guide July Getting Started Introduction Java ME TCK Framework Developer’s Guide July Use of the Framework Development EnvironmentTarget Environment Connectivity Requirements Cldc Target Device Resource Limitations Framework Components Framework Bundle Framework Components on the Device Side Framework Components on the Harness Side Test Types 1Configurations and Supported Test Types Automated Tests Distributed Tests 1Framework Configuration for Standard Automated Tests PC or Workstation Interactive Tests OTA Tests 3Framework Configuration for Interactive Tests OTA Writing an Automated Test Writing a Simple Automated Test To Create a Simple Automated Test Body Save this file in the Simple Test Suite source as SimpleTestSuite/tests/pkg3/index.html To Build an Updated Test Suite Building an Updated Simple Test Suite Testing an Updated Simple Test Suite To Test an Updated Test SuiteEnter the ant command to invoke the ant build script Writing a Simple Automated Test Java ME TCK Framework Developer’s Guide July Test Suite Structure Test Suite Construction Code Example 3-1Simple Test Suite testsuite.jtt File Testsuite.jtt File Tests Directory Lib Directory Test Case Test Class Classes Directory Test Description fileCode Example 3-2Simple Test Class Doc Directory Creating a Test Suite Configuration Interview TestHost=129.42.1.50 TestPort=8080 Define the environment variable required by the test Write the configuration interview class Following code creates the SampleInterview class Specify the question type Implement error checking for the question answer Question qXXX = Question getNext Return qNextQuestion SimpleTestSuite/src/sample/suite Set up the More Info system Update the interview .properties resource file Create a default directory under the help directory MapID target=name url=location/filename.html Create the More Info topic files Create a JAR file containing the configuration interview Building a Test Suite Writing Tests Testing Devices With Automated Tests 1Automated Test Execution Automated Test Execution Client Test Component Testing Communications or Networking With Distributed Tests Test Description for Distributed Tests Remote Test ComponentRequired Distributed Test Keyword Remote Attribute RemoteSource Attribute Distributed Test Execution 2Distributed Test Execution Testing User Interfaces With Interactive Tests Test Description for Interactive Tests Interactive Test Execution Required Interactive Test KeywordsCode Example 4-5Required Interactive Test Keywords 3Interactive Test Execution Example of an Interactive Test Testing Application Provisioning With OTA Tests Server Component of an OTA TestClient Test Component of an OTA Test Test Description for OTA Tests Required OTA Test KeywordCode Example 4-6Required OTA Test Keyword OTA Test Description Examples Code Example 4-9remote Attribute Entry for Trusted MIDletCode Example 4-10OTA Test Description File Code Example 4-11Trusted OTA Test Description File OTA Test Execution 4OTA Test Execution Code Example 4-12Server Test Component Example Example of OTA Test Untrusted Tests Types of Security Tests Trusted Tests Using Keywords to Mark Security TestsDouble-duty Tests Marking Untrusted Tests Code Example 4-14Test Description for an untrusted Test Marking Trusted Tests Code Example 4-17Test Description for a Double Duty Test Using an Attribute to Mark Double-Duty Tests Granting Security Permissions Granting or Denying Security Permissions Body Code Example 4-20deny Attribute in the Test Description Denying Security Permissions Adding Resource Files in Tests Code Example 4-23resources Attribute in the Test Description Code Example 4-22Test That Requires an Image Resource Code Example 4-24Test Description That Includes Resources Factors and Mechanisms for Test Selection Enabling Test Selection SelectIf Test Selection To Enable Test Selection with the selectIF Expression TD SCOPE=row BselectIf/B /TD TD isFeatureSupported /TD Body Html Java ME TCK Framework Developer’s Guide July Writing Tests Update the map file Create a More Info topic file for the questionCreate the JAR file Test API Code Example A-2Definition of main Test must also define main as follows J2MEDistributedTest OTATest Lib Directory Framework Bundle DTF Core Cldc and Midp ExecutionCldc and Midp Agents and Clients CommService Plug-insCommClients CDC Agents Test Export Support LibrariesCommServers Messaging Framework Server Classes and Interfaces Src Directory Digital Signer Agent ClassesPreverification Script Java ME Technology Version of Harness Classes Communication Channel Doc Directory Java ME TCK Framework Developer’s Guide July Test Description Fields Test Description Fields Keywords Table C-1Framework Test Description Fields Appendix C Test Description Fields and Keywords Table C-2Framework Keywords Keywords Identifies tests used with runtime products Java ME TCK Framework Developer’s Guide July Glossary Application IDentifier Boundary value Graphical User Java Archive JAR Maintenance Lead Program Management Structure-based Test command Java ME TCK Framework Developer’s Guide July Index Symbols Java ME TCK Framework Developer’s Guide July Work directory Java ME TCK Framework Developer’s Guide July