EJB Operations Details (Magic xpi 3.x)
When you define an EJB service in the Service Repository, you should click the Operations button to open the Operation dialog box. Here, you can define the service's operations and their parameters.
The Operation dialog box is split into three sections. The left pane is the Operation Name section. Click New to add a new operation.
The upper right pane is the Return Parameter Details section, where you define the value returned to the calling program. This consists of the following fields:
|
|
|
|
Type
|
Select one of the following data types from the drop-down list:
-
Alpha
-
Numeric
-
Logical
-
Date
-
Time
-
BLOB
|
|
Java Type
|
Select one of the following Java types from the drop-down list:
|
|
Picture
|
Define the returned parameter's format by entering a string of characters. For example, a 15-character alpha-numeric parameter has a picture definition of 15. A picture that defines a date is MM/DD/YYYY.
|
The lower right pane contains the Argument Details for the selected operation. Click New to add an argument to an operation. This section consists of the following fields:
|
|
|
|
Argument Name
|
Enter the argument name. The first argument, by default, is IBPrincipal, which cannot be modified. This argument contains the user name that is used to authenticate the flow, and is essentially a security feature.
|
|
Type
|
Select one of the following argument data types from the drop-down list:
-
Alpha
-
Numeric
-
Logical
-
Date
-
Time
-
BLOB
|
|
Format
|
The data type's format.
|
|
Java Type
|
The Java types available depend on the data type that you select in the Type field (above).
|
Data Type
|
Available Java Types
| |
Alpha
|
String, String Buffer
| |
Numeric
|
Float, Double, Long, Short, Byte
| |
Logical
|
Boolean
| |
Date
|
String
| |
Time
|
String
| |
BLOB
|
String, String Buffer, Byte, Object
|
|
|
Java Class Name
|
Enter the Java class name. Magic xpi looks for the Java classes in the Class Paths list or in the Class of the Java folder in your Project folder. When you add a class, Magic xpi can use it. This field is enabled only when the Type field is set to BLOB, and the Java Type field is set to Object.
|
Click Servers to select the J2EE enterprise servers that can be used to execute the EJB component. For more information, click here.
When you have finished, click OK to save your operations and to exit the dialog box. Alternatively, you can click Cancel to exit the dialog box without saving your operations.
