J2CA Resource Adapter Module User Exit

The Business Rules J2CA resource adapter module user exit is used to add and modify fields before AutoAdjust calls the Business Rules Server. It allows the user to examine the results and add or modify fields after the call to Business Rules Server returns. The Business Rules custom property UserClass must be configured for the user exit to take effect. Refer to Communicating with Business Rules for information on setting Business Rules custom properties.

This user exit is called at the initialization and termination of each Business Rules connection. These connections are maintained in a pool managed by the WebSphere® Application Server. The user exit is called after the user submits updates and before the next transaction is presented to the user. The user must ensure the exit code is efficient and does not adversely affect AutoAdjust processing.

The user exit must extend the com.ibm.paydir.izw.connector.user.UserBusinessRules class to ensure future compatibility. The UserBusinessRules base class implements the com.ibm.paydir.izw.connector.user.UserBusinessRulesInterface class and all the necessary getter and setter methods in the interface. The user must implement the following methods:
  • void initRequest (BrFieldList fieldList)
  • void initResponse (RequestResponse reqResponse, BrFieldList fieldList)
  • void itemRequest (PaymentValidation payValRecord, BrFieldList fieldList)
  • void itemResponse (PaymentValidation payValRecord, BrFieldList fieldList)
  • void termRequest
  • void termResponse (RequestResponse reqResponse)
These user exit methods have access to the following fields:
  • Sort pattern number (for example, sort type)
  • Business Rules workflow name

When compiling the user exit code, the _connectorModule.jar and pdapi.jar files must be included in the class path for the compiler. The UserBusinessRules and UserBusinessRulesInterface classes are packaged in the _connectorModule jar file.

The files for user exits are provided in the FTM artifacts pod and must be downloaded from the pod. For more information about getting files from the artifacts container for your offering, see Getting the files from the artifacts container for your FTM offering. The Java™ interface, UserBusinessRulesInterface, is described in the HTML files installed with AutoAdjust. To view the information about this interface, open the index.html file in a web browser and look for the class UserBusinessRulesInterface.