Using A Java Action Fault Policy In SOA Suite 11g

In this previous post about Error handling in SOA Suite 11G, I explained how you can create your own fault handling policy for your BPEL process.

This post describes how to call a Java action for error handling.

First we are going to create a new project in JDeveloper witch contains the Java class that will be called when an error occurs.

Add the following libraries to your project: SOA Runtime and BPEL Runtime.

Create a new Java class and let it implement the following interface: oracle.integration.platform.faultpolicy.IFaultRecoveryJavaClass.

The IFaultRecoveryJavaClass interface defines two operations: handleRetrySuccess and handleFault.

The handleRetrySuccess method is invoked upon a successful retry attempt and the handleFault method is invoked to execute a policy of type javaAction.

public interface IFaultRecoveryJavaClass {
    void handleRetrySuccess(IFaultRecoveryContext iFaultRecoveryContext) { }
    java.lang.String handleFault(IFaultRecoveryContext iFaultRecoveryContext) { }
}

The IFaultRecoveryContext contains methods for retrieving specified details about the error, the instance and properties you can define in the <Properties> section of the fault-policies.xml file (explained later).

Here follows a Java class example.

package nl.whitehorses.soa.demo;

import java.util.ArrayList;
import java.util.Map;

import oracle.integration.platform.faultpolicy.IFaultRecoveryContext;
import oracle.integration.platform.faultpolicy.IFaultRecoveryJavaClass;

public class FaultHandler implements IFaultRecoveryJavaClass {

    public void handleRetrySuccess(IFaultRecoveryContext iFaultRecoveryContext) {
        System.out.println("This is for retry success");
        handleFault(iFaultRecoveryContext);
    }

    public String handleFault(IFaultRecoveryContext iFaultRecoveryContext) {
        //print all fault details
        System.out.println("==========");
        System.out.println("Fault policy id: " + iFaultRecoveryContext.getPolicyId());
        System.out.println("Fault type: " + iFaultRecoveryContext.getType());
        System.out.println("Partnerlink: " + iFaultRecoveryContext.getReferenceName());
        System.out.println("Port type: " + iFaultRecoveryContext.getPortType());
        System.out.println("Properties found in propertySet:");
        //print all properties defined in the fault-policy file
        Map props = iFaultRecoveryContext.getProperties();
        for (Map.Entry entry : props.entrySet()) {
            System.out.println(entry.getKey() + ": " + entry.getValue().get(0));
        }
        System.out.println("==========");
        return "OK";
    }
}

The Java file must be deployed as a jar file in the lib folder of the SOA-suite domain ($ORACLE_MIDDLEWARE_HOME/user_projects/domains/soa_domain/lib).

Next we have to create a BPEL process with a fault-bindings and fault-properties file, see this post.

In the fault-policies.xml file we must declare an Action of type javaAction. In the properties section we can add some properties we can use in our Java code (in this example I created a property called myProperty with the value My Porperty value).

<?xml version="1.0" encoding="UTF-8"?>
<faultPolicies xmlns="http://schemas.oracle.com/bpel/faultpolicy"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <faultPolicy version="2.1.3" id="ConnectionFaults">
    <Conditions>
      <faultName xmlns:bpelx="http://schemas.oracle.com/bpel/extension"
                 name="bpelx:remoteFault">
        <condition>
          <action ref="java-fault-handler"/>
        </condition>
      </faultName>
    </Conditions>
    <Actions>
      <Action id="java-fault-handler">
        <javaAction className="nl.whitehorses.soa.demo.FaultHandler"
                    defaultAction="ora-human-intervention"
                    propertySet="properties">
          <returnValue value="OK" ref="ora-human-intervention"/>
        </javaAction>
      </Action>
    </Actions>
    <Properties>
      <propertySet name="properties">
        <property name="myProperty">My Property value</property>
      </propertySet>
    </Properties>
  </faultPolicy>
</faultPolicies>

The next figure shows a part the output from the Managed server when the Java class is invoked.

Ratings:

VN:F [1.9.22_1171]

please wait...

Rating: 5.0/5 (2 votes cast)

• 

 Print This PDF Version