Connect-Java method
Use the Connect-Java method to call a public method of an external Java class, using a Rule-Connect-Java rule.
Parameters
This method operates on a named clipboard page that is the source and destination of data mappings. Make sure the Step Page column that calls this method contains the non-blank name of such a page.
This method has two parameters:
Parameter | Description |
---|---|
ServiceName | Enter the Service Name (second key part) of a Connect Java rule, an instance of the Rule-Connect-Java rule type. The system uses the class of the step page as the first key part. |
RunInParallel | Select if this connector is intended to run in parallel as a child requestor of the current requestor. If selected, use the Connect-Wait method later in the current or a follow-on activity to access results from the connector. |
Results
The Connect-Java method works as follows:
- Using rule resolution, locates the Connect Java rule identified by the ServiceName parameter and the class of the step page or primary page.
- Uses request information to call one of the Java class constructors or one of the Java class business methods method.
- If the step page does not exist, creates a new page, of the class identified in the Pages & Classes tab.
- Checks whether simulation is in force for this rule. If so, calls the simulation stub activity.
- If simulation is not in force, calls the Java method. It creates a separate requestor if the RunInParallel box is selected. This temporary requestor has the same access group and clipboard as the original. At most 10 such child requestor sessions can be active at once.
- Processes the response when it is received.
Checking the method status
This method updates the pxMethodStatus property. See How to test method results using a transition.CAUTION:
Design the
activity to detect and handle exceptions. If the Connect-Java method with the RunInParallel
check box selected fails in a way that causes the Connect-Wait method to be skipped, the
child requestor can be left hanging. If the limit of parallel requestors is then eventually
reached, the parent requestor will fail as well. By default, the limit is 10 requestors in
parallel; you can establish a higher or lower value in the
prconfig.xml
file or dynamic system settings using the services/maxRequestorChildren
setting. Restrictions
This method cannot be used in a step that involves iteration.