Fujitsu J Adapter Class Generator User Manual page 66

66 Chapter 5. Adapter Class Reference
Expansion format
CLASS-ID. internal-class-1 AS "external-class-name" INHERITS internal-
class-name-2.
...
FACTORY.
...
<<NEW-ARRAY method>>
END FACTORY.
OBJECT.
...
<<GET-ARRAY-LENGTH method>>
<<GET-ARRAY-ELEMENT method>>
<<SET-ARRAY-ELEMENT method>>
END OBJECT.
END CLASS internal-class-name-1.
Generation rules
1. Internal class names 1 and 2 are internally used by the J adapter class generator
and are not viewed from the class user.
2. The external class name is used to identify the class. The class user can identify
the class with the external class name.
3. An external class name is generated according to the following rules:
JA-NumberOfDimensions-ElementTypeName
"JA-" is followed by the number of dimensions (1 to 9) and element type
-
name with a hyphen "-" inserted in between them.
An element type name is generated depending on the type in the following
-
format:
Object: External class name of the adapter class corresponding to the Java
-
class (See "
Basic type: Java keyword representing a type (boolean, byte, char, short,
-
int, long, float, or double)
An external class name exceeding 160 characters is truncated after the
-
160th character.
4. The following methods are generated in the factory or method definition:
Method name
NEW-ARRAY
GET-ARRAY-LENGTH
GET-ARRAY-ELEMENT
SET-ARRAY-ELEMENT
5. An n-dimensional array is handled as a one-dimensional array having an n-1-
dimensional array as an element. Therefore, for n-dimensional array, n adapter
classes (JA-n-XYZ, JA-(n-1)-XYZ, ..., JA-1-XYZ) are generated. JA-n-XYZ is a
one-dimensional array having JA-(n-1)-XYZ as an element.
Generation example
The adapter class for java.lang.String[] is generated as shown below:
Class and interface
.")
Type Function
Factory Generates an array object.
Object Obtains the number of elements of an array.
Object Fetches a value from an array element.
Object Sets a value in an array element.