Overview

• Home
• Release Note
• FAQ
• WS-BPEL Compliance
• License

Installation Guide

• Installing WSO2 BPS
• External Data Source Configurations
• Registry Configurations
• OpenJPA Configurations
• Http Configurations

Quick Start Guide

• Modeling the process
• Deploying the process
• Testing the process

Concepts

• Process Versioning
• Process instance events
• Partner links

User Guide

• Deploying BPEL processes
• Managing BPEL processes
• Managing BPEL process instances
• QoS for BPEL processes
• Securing BPEL processes
• Configuring JMS Transport
• Deployment Best Practices
• Process Instance Cleanup
• Process Hydration and Dehydration

WS-BPEL Extensions

• Activity Failure and Recovery
• Extension Activities and Extensible Assign Operations
• XPath Extensions
• Iterable ForEach
• Flexible Assigns

Samples

• HelloWorld
• IF
• ForEach
• While
• Repeat Until
• Flow and Links
• Pick
• Synchronous and Asynchronous Service Invocations
• Fault Handling
• Split
• XslTransform
• Compensation Handler

Project Information

• Library
• Source Code
• Mailing Lists
• Issue Tracking

WSO2 BPS - Sample Guide - Fault Handling

Sample Guide - Fault Handling

Table of Content

• Objective
• Prerequisites
• Overall Idea

Objective

This sample explains about basic fault handling. In fault handling, <throw/> and <rethrow/> are used to generate faults where faults occurs.

• <throw/> Faults should be named with a unique scope level qualified name.

  eg -

  <throwfaultName="saw:InputException2"/>

• <rethrow/> is used only inside <catch/> or <catchAll/> which will be described later in order to re-throw the originally caught exceptions.

  eg -

  <catchAll><rethrow/></catchAll>

• The fault handling is implemented inside <faultHandlers/>. Faults can be handled based on qualified name of the thrown fault using <catch/> or Every non-specified faults can be handles inside <catchAll/>.

  eg -

  <faultHandlers><catchfaultName="saw:InputException2"><throwfaultName="saw:Exception1Handled"/></catch><catchAll><rethrow/></catchAll></faultHandlers>

Note - <faultHandlers/> should be defined in a parent scope.

Prerequisites

• Log in into BPS server admin console.
• Under Business Processes -> Add BPEL.
• Upload the TestThrowCatchFaultHandling.zip , (all samples are located at our sample repository.)
• Under the Business Processes -> Processes.
• Under the WSDL details widget -> Create instance

Overall Idea

Refer - TestThrowCatchFaultHandling.zip

In the child scope the input value is checked whether it's equal to 1. If so an InputException1 is thrown. Note that the thrown exception has a "saw:InputException1" qualified name.

eg -

<ifname="ExceptionCondition1"><condition>number($value)=number(1)</condition><throwfaultName="saw:InputException1"/><else><throwfaultName="saw:TransitionConditionOutOfRangeException1"/></else></if>

In the parent scope the exception is filtered against its qualified name.

eg -

<faultHandlers><catchfaultName="saw:InputException1"><ifname="ExceptionCondition2"><condition>true()</condition><throwfaultName="saw:InputException2"/><else><throwfaultName="saw:TransitionConditionOutOfRangeException2"/></else></if></catch></faultHandlers>