Chapter 2Procedure for SOAP with Attachments API for Java 1.3 Certification
This chapter describes the compatibility testing process and compatibility
requirements for SOAP with Attachments API for Java 1.3. This chapter contains the following
sections:
2.1 Certification Overview
The certification process for SOAP with Attachments API for Java 1.3 consists of the following
activities:
Install the appropriate version of the Technology Compatibility
Kit (TCK) and execute it in accordance with the instructions in this User's
Guide.
Ensure that you meet the requirements outlined in Compatibility Requirements.
Certify to Java Licensee Engineering that you have finished
testing and that you meet all the compatibility requirements.
2.2 Compatibility Requirements
The compatibility requirements for SOAP with Attachments API for Java 1.3 consist of meeting
the requirements set forth by the rules and associated definitions contained
in this section.
2.2.1 Definitions
These definitions are for use only with these compatibility requirements
and are not intended for any other purpose.
Table 2-1 Definitions
Term | Definition |
Computational Resource | A piece of hardware or software that may vary in quantity, existence,
or version, which may be required to exist in a minimum quantity and/or at
a specific or minimum revision level so as to satisfy the requirements of
the Test Suite. Examples of computational resources that may vary in quantity are RAM
and file descriptors. Examples of computational resources that may vary in existence (that
is, may or may not exist) are graphics cards and device drivers. Examples of computational resources that may vary in version are operating
systems and device drivers. |
Configuration Descriptor | Any file whose format is well defined by a specification and which contains
configuration information for a set of Java classes, archive, or other feature
defined in the specification. |
Conformance Tests | All tests in the Test Suite for an indicated Technology Under Test,
as distributed by the Maintenance Lead, excluding those tests on the Exclude
List for the Technology Under Test. |
Documented | Made technically accessible and made known to users, typically by means
such as marketing materials, product documentation, usage messages, or developer
support programs. |
Exclude List | The most current list of tests, distributed by the Maintenance Lead,
that are not required to be passed to certify conformance. The Maintenance
Lead may add to the Exclude List for that Test Suite as needed at any time,
in which case the updated Exclude List supplants any previous Exclude Lists
for that Test Suite. |
Libraries | The class libraries, as specified through the Java Community Process
(JCP), for the Technology Under Test. The Libraries for SOAP with Attachments API for Java 1.3 are
listed at the end of this chapter. |
Location Resource | A location of classes or native libraries that are components of the
test tools or tests, such that these classes or libraries may be required
to exist in a certain location in order to satisfy the requirements of the
test suite. For example, classes may be required to exist in directories named in
a CLASSPATH variable, or native libraries may be required
to exist in directories named in a PATH variable. |
Maintenance Lead | The Java Community Process member responsible for maintaining the Specification,
reference implementation, and TCK for the Technology. Sun is the Maintenance
Lead for SOAP with Attachments API for Java 1.3. |
Operating Mode | Any Documented option of a Product that can be changed by a user in
order to modify the behavior of the Product. For example, an Operating Mode can be binary (enable/disable optimization),
an enumeration (select from a list of protocols), or a range (set the maximum
number of active threads). |
Product | A licensee product in which the Technology Under Test is implemented
or incorporated, and that is subject to compatibility testing. |
Product Configuration | A specific setting or instantiation of an Operating Mode. For example, a Product supporting an Operating Mode that permits user
selection of an external encryption package may have a Product Configuration
that links the Product to that encryption package. |
Resource | A Computational Resource, a Location Resource, or a Security Resource. |
Rules | These definitions and rules in this Compatibility Requirements section
of this User's Guide. |
Security Resource | A security privilege or policy necessary for the proper execution of
the Test Suite. For example, the user executing the Test Suite will need the privilege
to access the files and network resources necessary for use of the Product. |
Specifications | The documents produced through the Java Community Process that define
a particular Version of a Technology. The Specifications for the Technology Under Test can be found later
in this chapter. |
Technology | Specifications and a reference implementation produced through the Java
Community Process. |
Technology Under Test | Specifications and the reference implementation for SOAP with Attachments API for Java 1.3. |
Test Suite | The requirements, tests, and testing tools distributed by the Maintenance
Lead as applicable to a given Version of the Technology. |
Version | A release of the Technology, as produced through the Java Community
Process. |
2.2.2 Rules for SOAP with Attachments API for Java 1.3 Products
The following rules apply for each version of an operating system, software
component, and hardware platform Documented as supporting the Product:
The Product must be able to satisfy all applicable compatibility
requirements, including passing all Conformance Tests, in every Product Configuration
and in every combination of Product Configurations, except only as specifically
exempted by these Rules.
For example, if a Product provides distinct
Operating Modes to optimize performance, then that Product must satisfy all
applicable compatibility requirements for a Product in each Product Configuration,
and combination of Product Configurations, of those Operating Modes.
If an Operating Mode controls a Resource necessary for the
basic execution of the Test Suite, testing may always use a Product Configuration
of that Operating Mode providing that Resource, even if other Product Configurations
do not provide that Resource. Notwithstanding such exceptions, each Product
must have at least one set of Product Configurations of such Operating Modes
that is able to pass all the Conformance Tests.
For example, a
Product with an Operating Mode that controls a security policy (i.e., Security
Resource) which has one or more Product Configurations that cause Conformance
Tests to fail may be tested using a Product Configuration that allows all
Conformance Tests to pass.
A Product Configuration of an Operating Mode that causes the
Product to report only version, usage, or diagnostic information is exempted
from these compatibility rules.
Some Conformance Tests may have properties that may be changed.
Properties that can be changed are identified in the TCK configuration interview.
Apart from changing such properties and other allowed modifications described
in this User's Guide (if any), no source or binary code for a Conformance
Test may be altered in any way without prior written permission. Any such
allowed alterations to the Conformance Tests would be posted to the Java Licensee
Engineering web site and apply to all licensees.
The testing tools supplied as part of the Test Suite or as
updated by the Maintenance Lead must be used to certify compliance.
The Exclude List associated with the Test Suite cannot be
modified.
The Maintenance Lead can define exceptions to these Rules.
Such exceptions would be made available to and apply to all licensees.
All hardware and software component additions, deletions,
and modifications to a Documented supporting hardware/software platform, that
are not part of the Product but required for the Product to satisfy the compatibility
requirements, must be Documented and available to users of the Product.
For example, if a patch to a particular version of a supporting operating
system is required for the Product to pass the Conformance Tests, that patch
must be Documented and available to users of the Product.
The Product must contain the full set of public and protected
classes and interfaces for all the Libraries. Those classes and interfaces
must contain exactly the set of public and protected methods, constructors,
and fields defined by the Specifications for those Libraries. No subsetting,
supersetting, or modifications of the public and protected API of the Libraries
are allowed except only as specifically exempted by these Rules.
The Product may contain a subset of the classes and interfaces
for the Libraries.
Except for tests specifically required by this TCK to be rebuilt
(if any), the binary Conformance Tests supplied as part of the Test Suite
or as updated by the Maintenance Lead must be used to certify compliance.
The functional programmatic behavior of any binary class or
interface must be that defined by the Specifications.
|