Fujitsu J Adapter Class Generator Manual do Utilizador

J Adapter Class Generator User’s Guide

10 Chapter 1. Outline of J Adapter Class Generator What is the J Adapter Class Generator? Taking advantage of the object-oriented function, Fujit

Chapter 1. Outline of J Adapter Class Generator 11 The Java class interface must be converted into the COBOL interface for a COBOL program to use

12 Chapter 1. Outline of J Adapter Class Generator Therefore, the following restrictions apply to COBOL: - Listener Java registers a listener ob

Chapter 2. Adapter Class Generator Framework This chapter explains the framework of the J adapter class generator.

14 Chapter 2. Adapter Class Generator Framework Adapter Class To make Java classes available to COBOL, a mechanism for converting the Java class

Chapter 2. Adapter Class Generator Framework 15 Adapter Object At execution time, an adapter class generates the adapter object corresponding to

16 Chapter 2. Adapter Class Generator Framework

Chapter 3. Developing Programs This chapter explains how to develop programs that use Java classes.

18 Chapter 3. Developing Programs Creating Adapter Classes This section explains how to generate an adapter class from a Java class. Investigati

Chapter 3. Developing Programs 19 adapter classes when the class file is not available, see "Generating an adapter class when the class fil

Seventh Edition: August 2005 The contents of this manual may be revised without prior notice. No part of this document may be reproduced or transmit

20 Chapter 3. Developing Programs Therefore, an adapter class cannot be generated normally without these class files. These class files may not

Chapter 3. Developing Programs 21 Example: When an application uses only the println (Object) method of the java.io.PrintStream class, specify a

22 Chapter 3. Developing Programs ... REPOSITORY. CLASS J-OBJECT AS "java-lang-Object" ... LINKAGE SECTION. 01 P1-OUTPUTSTREAM

Chapter 3. Developing Programs 23 Terminating the Java VM When an adapter class is no longer used, the Java VM must be terminated. Use the JVM-

24 Chapter 3. Developing Programs An example of generating a Date class object is shown below: ... REPOSITORY. CLASS J-Date AS "java-

Chapter 3. Developing Programs 25 An example of referencing the class variable AM_PM_FIELD (static field) of the DateFormat class is shown below

26 Chapter 3. Developing Programs An example of assigning an object, which has been referenced with Object class data, into Data class data is s

Chapter 3. Developing Programs 27 … When the -s option or the "Option String" parameter is specified, the conversion between the Str

28 Chapter 3. Developing Programs If an adapter class is generated by specifying the -t option or the "Option Terminal" parameter, the

Chapter 3. Developing Programs 29 DISPLAY "Error Code: " errCode. DISPLAY "Error Message: " errMessage(1:errMessageLe

Preface The "NetCOBOL J Adapter Class Generator" is a tool that generates a COBOL class (adapter class) used to call a Java class. Using th

30 Chapter 3. Developing Programs Conversion to Java2 When using the resources (execute-form programs (EXE), DLLs, adapter class source, and pro

Chapter 4. Using the Generator Command This chapter explains how to use the generator command (java2cob), optional file and output result.

32 Chapter 4. Using the Generator Command Starting the J Adapter Class Generator Command Syntax When the constructor/method/field is not specifi

Chapter 4. Using the Generator Command 33 generated. When specifying two or more constructors, they must be delimited by comma (,) or a blank.

34 Chapter 4. Using the Generator Command -om Specified to reduce the number of adapter classes generated. When this parameter is specified, th

Chapter 4. Using the Generator Command 35 name, replace the period "." of the internal class name with a dollar sign "$". M

36 Chapter 4. Using the Generator Command Optional File The optional file is a text format file used to define generator options in a file inste

Chapter 4. Using the Generator Command 37 Notes on describing the optional file: • Clauses enclosed by square brackets can be omitted. • Curly

38 Chapter 4. Using the Generator Command Option Code Specification format Option Code = { SJIS | UNICODE } Specification contents Specify a cod

Chapter 4. Using the Generator Command 39 Option MethodTable Specification format Option MethodTable { YES | NO } Specification contents Specify

Chapter 5. Adapter Class Reference Chapter 5 provides detailed information on the FJ-JAVA-BASE, FJ-JAVA-CONTROL and FJ-JAVA-ERROR classes provided by

40 Chapter 4. Using the Generator Command Option ReduceClass Specification format Option ReduceClass = { YES | NO } Specification contents Speci

Chapter 4. Using the Generator Command 41 Option Terminal Specification format Option Terminal = { YES | NO } Specification contents Specify whe

42 Chapter 4. Using the Generator Command Output The generator outputs the following files: • Adapter class source file • Generation name mana

Chapter 4. Using the Generator Command 43 Figure 4.1 Generation Name Management File The J adapter class generator uses a generation name manag

44 Chapter 4. Using the Generator Command A method name cross-reference list file is output in the following format: [Java] java-class-name [CO

Chapter 5. Adapter Class Reference This chapter provides detailed information on the FJ-JAVA-BASE, FJ-JAVA-CONTROL and FJ-JAVA-ERROR classes provided

46 Chapter 5. Adapter Class Reference Class Configuration The figure below shows the hierarchical relationships among the FJ-JAVA-BASE, FJ-JAVA-C

Chapter 5. Adapter Class Reference 47 FJ-JAVA-BASE class The FJ-JAVA-BASE class is the super class of every adapter class. The FJ-JAVA-BASE class

48 Chapter 5. Adapter Class Reference J-EQUALS Method (object method) Explanation This method checks whether the Java objects indicated by two ad

Chapter 5. Adapter Class Reference 49 Environment variable name Function COBJNI_MAX_NSTACK Specifies the maximum size (bytes) of the stack used

Registered Trademarks The registered trademarks appearing in this manual are as follows: Microsoft, Windows, and Windows NT are registered trademarks

50 Chapter 5. Adapter Class Reference FJ-JAVA-ERROR class The adapter class generates the exception object when some error is detected during exe

Chapter 5. Adapter Class Reference 51 GET-EXCEPTION method (object method) Explanation The Java exception information is returned. Syntax INVOKE

52 Chapter 5. Adapter Class Reference Data types The Java data types are mapped to the COBOL data types as shown below: Java data type COBOL data

Chapter 5. Adapter Class Reference 53 Expansion format CLASS-ID. internal-class-name-1 AS "external-class-name" INHERITS internal-class

54 Chapter 5. Adapter Class Reference Note: Fujitsu NetCOBOL does not distinguish between uppercase and lowercase letters of a class name. Ther

Chapter 5. Adapter Class Reference 55 6. When an exception is declared for the constructor, the RAISING specification is generated. Generation e

56 Chapter 5. Adapter Class Reference Class variable Explanation A public class variable (static field) is mapped to a COBOL property method (fac

Chapter 5. Adapter Class Reference 57 2. "out" is mapped to J-PRINTSTREAM (internal class name of java-io-PrintStream) because its att

58 Chapter 5. Adapter Class Reference Generation example The factory method corresponding to class method abs (long) of the java.lang.Math class

Chapter 5. Adapter Class Reference 59 - If a same property name has already been assigned, the second and subsequent property names are each suf

6 NetCOBOL J Adapter Class Generator User's Guide

60 Chapter 5. Adapter Class Reference Instance Method Explanation A non-public instance method (non-static method) is mapped to a COBOL object me

Chapter 5. Adapter Class Reference 61 Generation example The object method corresponding to instance method getTime() of the java.util.Date class

62 Chapter 5. Adapter Class Reference Parameter and return value • class-name Specifies the internal class name of the java-lang-String class de

Chapter 5. Adapter Class Reference 63 • createdObject (attribute: OBJECT REFERENCE SELF) Returns the generated object. Supplement When a data n

64 Chapter 5. Adapter Class Reference GET-STRING-N method (object method) Explanation This method fetches the character string from the String ob

Chapter 5. Adapter Class Reference 65 GET-STRING-LENGTH-N method (object method) Explanation This method returns the length of the character stri

66 Chapter 5. Adapter Class Reference Expansion format CLASS-ID. internal-class-1 AS "external-class-name" INHERITS internal-class-name

Chapter 5. Adapter Class Reference 67 CLASS-ID. JA-1-STRING AS "JA-1-java-lang-String" INHERITS J-OBJECT. ... END CLASS JA-1-STRIN

68 Chapter 5. Adapter Class Reference ... REPOSITORY. CLASS JA-2-INT AS "JA-2-int" CLASS JA-1-INT AS "JA-1-int"

Chapter 5. Adapter Class Reference 69 SET-ARRAY-ELEMENT method (object method) Explanation This method sets an element of an array object. Syntax

NetCOBOL J Adapter Class Generator User's Guide 7 Contents Chapter 1. Outline of J Adapter Class Generator...

70 Chapter 5. Adapter Class Reference Name that is always unique according to generation rules A class name is generated from a class name or int

Chapter 5. Adapter Class Reference 71 the J adapter class generator. For instance, the java.io.ObjectInputStream class inherits the java.io.Obje

72 Chapter 5. Adapter Class Reference read() read read(byte[]) read-01 java.io.ObjectInput interface read(byte[], int, int) java-io-ObjectInput c

Chapter 6. Messages This chapter explains the messages output by the J adapter class generator, including the operator responses to the messages.

74 Chapter 6. Messages Java2cob Command Messages This section explains the messages output by the java2cob command, including the operator respon

Chapter 6. Messages 75 Error: An invalid class name "xxx" was specified. Specify a Java class name or interface name qualified by a p

76 Chapter 6. Messages Warning: The method name of constructor "xxx" exceeded 160 characters. The characters after the first 160 char

Chapter 6. Messages 77 Messages Output during Execution This section explains the messages output during execution of programs using adapter clas

78 Chapter 6. Messages The current thread could not be connected to Java VM. Check whether the program properly invokes the JVM-ATTACH method. Th

Chapter 6. Messages 79 No Java field is found. Check whether the Java class/interface was changed after execution of the J adapter class generat

8 NetCOBOL J Adapter Class Generator User's Guide Messages Output during Execution ...

80 Chapter 6. Messages

Chapter 7. Samples Sample 1 – Using Classes Example 1: Example of using java.lang.System, java.io.PrintStream, and java.util.Date classes This secti

82 Chapter 7. Samples Generating adapter classes Generate adapter classes using the java2cob command. java2cob java. lang. Object [1] java2cob

Chapter 7. Samples 83 Sample 2 – Specifying Method Example 2: Example of generating an adapter class by specifying constructor/method/field This

84 Chapter 7. Samples Generating adapter classes Generate adapter classes using the java2cob command. java2cob -r java.lang.System -gf out \

Appendix A. Message List This chapter explains the messages output by the J adapter class generator, including the operator responses to the messages

86 Appendix A. Message List Java2cob Command Messages This section explains the messages output by the java2cob command, including the operator r

Appendix A. Message List 87 Messages Output during Generation This section explains the messages output during adapter class generation, includin

88 Appendix A. Message List Error: The suffix number exceeded 99. Generation was interrupted. Retry while specifying –r option, -gc option, -gm

Appendix A. Message List 89 Warning: The property name of field "xxx" exceeded 30 characters. The characters after the first 30 chara

Chapter 1. Outline of J Adapter Class Generator This chapter explains the function and operating environment of the J adapter class generator.

90 Appendix A. Message List Messages Output during Execution This section explains the messages output during execution of programs using adapter

Appendix A. Message List 91 The adapter class generated by the J adapter class generator contains a Java class name in invalid format. Contact t

92 Appendix A. Message List No Java method is found. Check whether the Java class/interface was changed after execution of the J adapter class g

Appendix B. Exception Type List The exception types that can be acquired by the GET-CODE method of the FJ-JAVA-ERROR class are described in this chap

94 Appendix B. Exception Type List 5 Meaning No Java field is found. Check whether the Java class/interface was changed after execution of the J

Appendix B. Exception Type List 95 10 Meaning A required Java class/interface definition is not found. Check the environment variable (COBJNI_CL

96 Appendix B. Exception Type List 15 Meaning An internal logical error (inconsistency between the return value and object reference) occurred.

Index adapter class, 14, 34, 46, 51 adapter object, 15 alphanumeric item, 27, 28, 34, 40 array, 65 assign, 25 -c, 32, 54, 63 class file, 18, 20 class

98 Index 98 -r, 20, 33, 34, 58 ReduceClass, 40 restrictions, 12 return value, 57 Runtime, 12 -s[n], 34 SET-ARRAY-ELEMENT, 69 source file, 19, 29