title

Checkbox - Checkbox Tests

name

Checkbox

source

CheckboxTests.java

executeClass

javasoft.sqe.tests.api.java.awt.Checkbox.CheckboxTests

keywords

runtime positive

executeArgs

-TestCaseID ALL

title

A descriptive string that identifies what the test does. The title appears in reports and in the JavaTest harness status window.

name

A string that identifies the test.

source

For compiler tests, the source field contains the names of the files that are compiled during the test run.

For runtime tests, the source field contains the names of the files previously compiled to create the test's class files. Precompiled class files are included with the JCK. Source files are included for reference only. Source files are often .java files, but can also be .jasm or .jcod files.

• .jasm is a low level bytecode assembler designed to assemble class files containing sets of bytecodes that are unusual or invalid for use in runtime tests

• .jcod is a class level assembler designed to build classes with unusual or invalid structure for use in runtime tests

These tools are used to generate class files that cannot be reliably generated by a Java compiler.

For most XML parser tests in the JCK runtime, the source field contains the names of the files that are processed during the test run. These files are XML Schema sources and XML documents usually having file name extensions of .xsd and .xml respectively. Such tests share a single precompiled class, TestRun, that invokes the XML parser under test through the Java technology API and passes the source file names to the parser for processing.

The test model is similar to compiler testing because the sources used in the tests contain valid and invalid use of various constructs of corresponding languages.

keywords

String tokens that can be associated with a given test. They describe attributes or characteristics of the test (for example, how the test should be executed, and whether it is a positive or negative test). Keywords are often used to select or deselect tests from a test run.

Keywords are described in detail in A.1.3 Keywords.

executeClass

The name of the main tests's class that the JavaTest harness loads and runs. This class might in turn load other classes when the test is run.

executeNative

The name of the platform-native program used to execute this test. This is specific to a few JNI implementation tests that launch a VM from native C code.

executeArgs

An array of strings that are passed to the test classes being executed. The arguments might be fixed but often involve symbolic values that are substituted from the test environment (variables defined elsewhere in the test environment). The result of substituting values can be seen in the resulting .jtr files.

These arguments form the basis for the set of arguments that are passed into the tests defined in executeClass and executeNative fields.

The default value of any variable not defined in the test environment is an empty string.

rmicClasses

For Java RMI tests, this nominates the set of classes that are passed to the Java RMI compiler.

timeout

A value specified in seconds used to override the default ten minute timeout used with all JCK tests.

context

Specifies configuration values required by the test. The JavaTest harness checks to be sure these values are set before it runs the test and passes the values through to the test. If any of these values are not defined, the JavaTest harness does not run the test.

Context-sensitive properties are described in detail in A.1.4 Context-Sensitive Properties.

selectIf

Specifies a condition that must be satisfied for the test to be executed. This field is constructed using environment values, Java programming language literals, and the full set of Boolean operators:

(+, -, *, /, <, >, <=, >=, &, |, !, !=, ==).

Example:

integerValue>=4 & display=="my_computer:0"

If the Boolean expression evaluates to false, the test is not run. If the expression evaluates to true, the test is run. If any of values are not defined in the test environment, the JavaTest harness considers the test to be in error.

remote

This entry contains information required to run distributed network tests.

jplisAgent

Specifies one Java PLIS agent. Following is the field value format:

agent-class-name options

• agent-clas-name is the fully-qualified class name of the JPLIS agent.

• options is a nonblank-space separated string that represents options to be passed to the agent specified by agent-class-name.

One test description table might be several jplisAgent fields. The jplisAgent field is processed only if the executed test has the jplis keyword in the list of keywords in the test description table.

apClass

The name of the annotation processor tests' class that is passed to the tested Java compiler.

apSource

Contains the names of files previously compiled to create the annotation processor's class files. The precompiled class files are included with the JCK.

apArgs

The annotation processor specific option value that is passed to the tested Java compiler. The value of this field is stored in the jckApArgs option name. The following is an example of passing the option with the standard JDK on Solaris:

-AjckApArgs=$apArgs.

compiler

Identifies tests used with compiler products.

interactive

Identifies tests that require human interaction.

negative

The component under test must terminate with (and detect) an error. An operation performed by a negative test on the component under test must not succeed.

only_once

Identifies tests that can only be run one time in the same VM. While tests are usually run once, it is possible that tests could be run more often. Tests with this keyword fail to run correctly if run more than once in the same VM.

positive

The component under test must terminate normally. An operation performed by the test on the component under test must succeed.

robot

If your system supports the awt.robot API, the tests can be run automatically. Otherwise, they run interactively.

runtime

Identifies tests used with runtime products.

serial

Used only with compiler tests. Identifies a test whose source files must be compiled one at a time by separate compiler invocations.

If serial is not specified, the source files are compiled by group (.java).

distributed

Identifies distributed tests that validate functionality while the test platform is connected to a remote host.

idl_inherit

Identifies tests that require the IDL-to-Java programming language translator to output Java technology interfaces that use the inheritance object model.

idl_tie

Identifies tests that require the IDL-to-Java programming language translator to output Java technology interfaces that use the TIE object model.

java_to_schema

Identifies JAXB tests that validate Java-to-Schema mapping.

jaxb

Identifies JAXB tests that validate API and Java-to-Schema mapping.

jaxws

Identifies tests that validate JAX-WS functionality.

jniinvocationapi

Identifies tests that use the JNI implementation.

jplis

Identifies JPLIS tests that require separate execution in single-VM mode and special options in the tested Java technology command line.

jplislivephase

Identifies JPLIS Live Phase tests that require separate execution in single-VM mode and that require support of an optional mechanism to start instrumentation agents some time after the VM has started without specifying agents through Java platform command line options.

jvmti

Identifies JVM TI tests that require separate execution in single-VM mode and special options in the tested Java technology command line.

jvmtilivephase

Identifies JVM TI Live Phase tests that require separate execution in single-VM mode and that require support of an optional mechanism to start instrumentation agents some time after the VM has started without specifying agents through Java platform command line options.

jdwp

Identifies JDWP tests that require separate execution in single-VM mode and special options in the tested Java technology command line.

needsharedclassloader

Identifies tests that must be loaded by the same class loader when they are run in single-VM mode. Tests with this keyword must use the same native library due to the Java SE limitation that does not allow the same native library to be loaded by different class loaders.

rmi_v11

Identifies RMI compiler tests that require version 1.1 stubs or skeletons to be produced by the RMI compiler.

rmi_iiop

Identifies RMI tests that use the IIOP transport layer.

network.fileURL

URL

A file URL for the network tests.

For example:

file:///C:\\AUTOEXEC.BAT

network.ftpURL

URL

An FTP URL for the network tests.

For example:

ftp://javator/etc/hosts

network.httpURL

URL

An HTTP URL for the network tests to use.

For example:

http://www.sun.com

network.jckHTTPProxyHost

Proxy name

The name of the HTTP proxy server to be used by JCK tests if a direct connection is not used.

For example:

fproxy.somewhere.com

network.jckHTTPProxyPort

Port number

The port number of the HTTP proxy server to be used by JCK tests if a direct connection is not used.

For example:

8080

network.localHost

Hostname and IP address

The name and IP address of the local host.

For example:

ruffles/129.144.75.50

network.tcpPortRange

Range of ports

On some systems, the set of ports allocated by the OS is different from the set of ports that can be specifically requested by client code. In this case, network.tcpPortRange must be set to indicate to the test the range of ports that are available. The lower limit is 1024 and the upper limit is 65535.network.tcpPortRange test configuration value

For example:

2048-5096

network.testHost1

Hostname and IP address

A host used for network tests.

For example:

satchmo/129.144.250.133

network.testHost2

Hostname and IP address

Another test host (different from testHost1).

For example:

doppio/129.144.173.35

network.udpPortRange

Range of ports

On some systems, the set of ports that are allocated by the OS is different from the set of ports that can be specifically requested by client code. In this case, network.udpPortRange must be set to indicate to the test the range of ports that are available. The lower limit is 1024 and the upper limit is 65535.

For example:

2048-5096

remote.networkAgent

-host hostname

-port port number (optional)

-classpath classpath (optional)

The distributed server to use with distributed tests.

For example:

-host doppio

-port 345

-classpath D:\classess

hardware.xFP_ExponentRanges

Integer

Runtime argument for floating-point tests. For more information, see Chapter 5.

For example:

-16382:16383:-16382:16383¹

platform.canPlayMidi

Boolean

Specifies if the system can play MIDI encoded sound.

For example:

false

platform.canPlaySound

Boolean

Specifies if the system supports the ability to play sampled audio.

For example:

true

platform.canRecordSound

Boolean

Specifies if the system supports the ability to record sound.

For example:

true

platform.expectOutOfMemory

Boolean

Indicates if the tested system can throw an OutOfMemoryError.

For example:

true

platform.hasPrinter

Boolean

Indicates if a printer is connected to the tested system. If a printer is connected to the system and is online, the value must be set to true.

For example:

true

platform.isFallbackSupported

Boolean

Indicates if the system performs the verification by the type inference when the typechecking fails.

For example:

true

platform.isHeadless

Boolean

Indicates if the tested system is headless (does not have a display device, a keyboard, or mouse).

For example:

false

platform.JavaSecurityAuthPolicy

String

Specifies the mechanism your product uses to specify the Java platform Security Authorization Policy used to run JAAS tests.

For example:

java.security.auth.policy

platform.JavaSecurityAuthLoginConfig

String

Specifies the mechanism your product uses to specify the Java platform Security Login Configuration used to run JAAS tests.

For example:

java.security.auth.login.config

platform.JavaSecurityKrb5KDC

String

VM System Property to set the Java platform Security Kerberos Key Distribution Center.

For example:

java.security.krb5.kdc

platform.JavaSecurityKrb5Realm

String

VM System Property to set the Java platform Security Kerberos Key Distribution Center realm.

For example:

java.security.krb5.realm

platform.KDCHostName

String

Host name of the Kerberos Key Distribution Center.

For example:

plop.sfbay.sun.com

platform.jdwpSupported

Boolean

Indicates if the JDWP implementation is provided on your system.

For example:

true

platform.jvmtiSupported

Boolean

Indicates if the system supports JVM TI.

For example:

true

platform.MultiVM

Boolean

Specifies if your system can load and run separate instances of a tested VM.

For example:

false

platform.KDCRealm

String

Kerberos realm name containing the following two accounts that are operating.

For example:

PLOP

platform.KerberosClientPassword

String

Password for the second principal.

For example:

xxxxxxx

platform.KerberosClientUsername

String

Second Kerberos principal name.

For example:

client

platform.KerberosServerUsername

String

First Kerberos principal name.

For example:

server

platform.KerberosServerPassword

String

Password for the first principal.

For example:

xxxxxxx

platform.Krb5LoginModuleConfigured

Boolean

Indicator whether module com.sun.security.auth.module. Krb5LoginModule is configured in the JRE software.

For example:

true

platform.maxMemory

Positive double or zero with optional postfix m or k

Amount of memory a test might allocate (in megabytes, kilobytes, or bytes).

For example:

205m

platform.nativeCodeSupported

Boolean

Indicates if the system supports direct access to native code (including but not limited to JNI implementation).

For example:

true

platform.robotAvailable

Boolean

Indicates if the system supports low-level input control (provided by java.awt.robot classes)

For example:

true

platform.rowSetFactory

String

The fully qualified name of the factory class used for creating the rowsets.

latform.soundURL

URL

The URL path to a sound file available to the system. The URL is used by various sound tests for playback and conversion testing. The URL should be a sound file (wav, au, or snd) that your system is capable of playing.

Example:

file:

$testSuiteRootDir$/api$/javax_sound $/sound.wav

platform.staticSigTestClasspath

Classpath

List of directories and ZIP or JAR files where the classes tested by the Static Signature Test are located, separated with a system-dependent path separator.

Example:

/usr/local/java/solsparc/jre /lib/rt.jar

platform.supportStaticSigTest

Boolean

Boolean value that indicates whether the static signature test is executed on the system being tested. The static signature test must be executed if the class files for the JRE software are delivered in a directory hierarchy, or in a ZIP or JAR file.

Example:

true

Pass

A test passes when the functionality being tested behaves as expected. All tests are expected to have passing results.

Fail

A test has failing results when the functionality being tested does not behave as expected.

Error

A test is considered to be in error when something (usually a configuration problem) keeps the test from being executed as expected. Errors often indicate a systemic problem. A single configuration problem can cause many tests to fail. For example, if the path to the runtime is configured incorrectly, the harness cannot run tests and identifies them as having errors.

Tests (JavaTest harness GUI)

The JavaTest harness finds tests listed in the Tests to be Run field of the Configuration Editor. You can specify sub-branches of the tree as a way of limiting the tests executed during a test run. The JavaTest harness walks the tree starting with the sub-branches or tests you specify and executes all tests that it finds. See Chapter 4 for more information.

Exclude list (JavaTest harness GUI)

Tests listed in the appropriate exclude list are deselected prior to the start of a test run. For details about exclude lists and their role in the certification process, see Chapter 2. For a description about how to specify an exclude list using the Configuration Editor, see Chapter 4.

Keywords (JavaTest harness GUI)

A test can be selected based on keywords specified in the keywords field in the test description. JCK keywords are described in detail in A.1.3 Keywords. For a description about how to use keywords with the JavaTest harness Configuration Editor, see Chapter 4.

Prior Status

Use the checkboxes to select tests in a test run based on their outcome on a prior test run. Prior status is evaluated on a test-by-test basis using information stored in result files (.jtr) written in the work directory.

selectIf field (Test Description table)

The selectIf field in the test description table contains an expression composed of elements from the test environment, Java programming language literals, and the standard operators:

+, -, *, /, <, >, <=, >=, &, |, !, !=, ==

For example:

integerValue>=4 & display=="my_computer:0"

These expressions are evaluated prior to the start of the test run. If the expression evaluates to true, then the test is selected as part of the test run. If the expression evaluates to false, or if any of the elements are not defined in the test environment, the test is not selected.