• an Apache ODE instance (preferably deployed in Tomcat)
• Maven 2.2.0
• JDK 1.6
• Netbeans 6.8,
• Mule CE 2.2.2-SNAPSHOT

Of course, it might work with other version but these are the versions I used.

Step 1: Create a running BPEL process

The first step is to create a running BPEL example. I use the latest version of Netbeans for that and
this post. To make use of the SOA wizards in the new Netbeans you have to enable this as an extension as described here.
To create the BPEL example perform the following steps:

1. Creating a new BPEL module named 'TextModule'
   
2. Add a WSDL to the project

Add a WSDL that describes the web service (remark: I wasn't able to create a document-literal web service with the wizard in Netbeans so I edited the source by hand afterwards). Here is my WSDL.

3. Add a BPEL process to the module, name it 'txtLengthProcess'
   

   This created process is empty so add functionality to it by following the guidelines as in this post. I ended up with the following process diagram:
   
   The mapping in the assignment step looks like this:
   
   I created the necessary variables to assign the values to in the 'receive' and 'reply' step.

4. Create a file 'deploy.xml'
   My file has the following content:
   PLAIN TEXT
   XML:

   1. <?xml version="1.0" encoding="UTF-8"?>
   2. <deploy xmlns="http://www.apache.org/ode/schemas/dd/2007/03"
   3.     xmlns:pns="http://www.redstream.nl/TxtLengthProcess"
   4.     xmlns:wns="http://www.redstream.nl/TxtLengthService">
   5.  
   6.     <process name="pns:TxtLengthProcess">
   7.         <active>true</active>
   8.         <provide partnerLink="TxtLengthPartnerLink">
   9.             <service name="wns:TxtLengthServiceService" port="TxtLengthServicePort"/>
   10.         </provide>
   11.     </process>
   12. </deploy>

5. Deploy it to the Tomcat instance that is running Apache ODE
   To deploy the process create a directory named 'TxtLengthService' under '/webapps/ode/WEB-INF/processes'. Copy the three files (deploy.xml, TxtLengthProcess.bpel and TxtLengthService.wsdl) to this directory. When your deployment was successful you’ll see the 'TxtLengthService.wsdl' at http://localhost:8080/ode/services/listServices:
   
6. (Optional) you can test the service with SoapUI
   With a successful request-response you will get the following result:
   

If you want more details on how to set up a Apache ODE service have look here. It goes into more detail then I am in this post.

Step 2: Generate Java client for web service to start ODE process

We use Metro for this because we had some bad experiences when using CXF for this. It is described here how to do this in combination with Maven.
I created a new Maven project with this 'pom.xml'.
When the client is generated you can test it with a test class like this:

PLAIN TEXT
JAVA:
1. package nl.redstream.ws.test;
2.  
3. import nl.redstream.txtlengthservice.TxtLengthService;
4. import org.junit.Test;
5.  
6. /**
7. *
8. * @author pascal
9. */
10. public class TestService {
11.  
12.     @Test
13.      public void testIt()
14.     {
15.         TxtLengthService service = new TxtLengthService();
16.  
17.         String value = service.getTxtLengthServiceSOAP11PortHttp().txtLengthOperation("RedStream");
18.  
19.         System.out.println("result = " + value);
20.     }
21. }

Step 3: Create the Mule project

To let Mule call the BPEL process I created a new Maven project that is able to test the call with a Mule client. The project is based on this 'pom.xml'.
The used 'ode-test-config.xml' looks like:

PLAIN TEXT
XML:
1. <?xml version="1.0" encoding="UTF-8"?>
2. <mule xmlns="http://www.mulesource.org/schema/mule/core/2.2"
3.        xmlns:spring="http://www.springframework.org/schema/beans"
4.        xmlns:test="http://www.mulesource.org/schema/mule/test/2.2"
5.        xmlns:vm="http://www.mulesource.org/schema/mule/vm/2.2"
6.        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7.        xsi:schemaLocation="
8.        http://www.mulesource.org/schema/mule/core/2.2 http://www.mulesource.org/schema/mule/core/2.2/mule.xsd
9.        http://www.mulesource.org/schema/mule/test/2.2 http://www.mulesource.org/schema/mule/test/2.2/mule-test.xsd
10.        http://www.mulesource.org/schema/mule/vm/2.2 http://www.mulesource.org/schema/mule/vm/2.2/mule-vm.xsd
11.        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
12.  
13.     <model name="mule-ode">
14.         <service name="start">
15.             <inbound>
16.                 <vm:inbound-endpoint path="msg-in" synchronous="true"/>
17.             </inbound>
18.             <component class="nl.redstream.mule.BpelProcessClient" />
19.         </service>
20.     </model>
21. </mule>

The created component class that handles the call to the SOAP client looks like:

PLAIN TEXT
JAVA:
1. package nl.redstream.mule;
2.  
3. import nl.redstream.txtlengthservice.TxtLengthService;
4.  
5. /**
6. *
7. * @author pascal
8. */
9. public class BpelProcessClient {
10.  
11.     public String callProcess(String request) {
12.         return new TxtLengthService().getTxtLengthServiceSOAP11PortHttp().txtLengthOperation(request);
13.     }
14. }

And the used test class looks like:

PLAIN TEXT
JAVA:
1. package nl.redstream.mule;
2.  
3. import org.junit.Test;
4. import org.mule.api.MuleException;
5. import org.mule.api.MuleMessage;
6. import org.mule.module.client.MuleClient;
7. import org.mule.tck.FunctionalTestCase;
8.  
9. public class BpelProcessClientTest extends FunctionalTestCase {
10.  
11.     private MuleClient client = null;
12.    
13.     protected MuleClient getClient() {
14.         try {
15.             if (client == null) {
16.                 client = new MuleClient();
17.             }
18.         } catch (MuleException e) {
19.             throw new RuntimeException(e);
20.         }
21.         return client;
22.     }
23.  
24.    protected final String getConfigResources() {
25.         return "config/ode-test-config.xml ";
26.     }
27.    
28.     @Test
29.     public void testBpelTest() throws MuleException
30.     {
31.         MuleMessage msg = getClient().send("vm://msg-in", "123456789012345", null);
32.         System.out.println("payload = " + msg.getPayload());
33.     }
34. }

When the test class is executed this results in the following output:

**********************************************************************
* Mule ESB and Integration Platform *
* Version: 2.2.2-SNAPSHOT Build: 15252 *
* MuleSource, Inc. *
* For more information go to http://mule.mulesource.org *
* *
* Server started: 12/17/09 8:34 PM *
* Server ID: 3d3eb71b-eb43-11de-bca6-7b92b51f04e0 *
* JDK: 1.6.0_17 (mixed mode) *
* OS encoding: MacRoman, Mule encoding: UTF-8 *
* OS: Mac OS X (10.6.2, x86_64) *
* Host: macbook-van-pascal-alma.local (192.168.1.204) *
* *
* Agents Running: None *
**********************************************************************
INFO 2009-12-17 20:34:50,730 [main] org.mule.module.client.MuleClient: Using existing MuleContext: org.mule.DefaultMuleContext@1d6b6c55
INFO 2009-12-17 20:34:50,756 [main] org.mule.transport.vm.VMMessageDispatcher: Connected: endpoint.outbound.vm://msg-in
payload = 15
INFO 2009-12-17 20:34:51,784 [main] org.mule.transport.vm.VMConnector: Removing listener on endpointUri: vm://msg-in
INFO 2009-12-17 20:34:51,784 [main] org.mule.transport.vm.VMMessageReceiver: Disconnected: VMMessageReceiver{this=5a56182f, receiverKey=msg-in, endpoint=vm://msg-in}
INFO 2009-12-17 20:34:51,785 [main] org.mule.component.DefaultJavaComponent: Stopping: org.mule.component.DefaultJavaComponent component for: SedaService{start}
INFO 2009-12-17 20:34:51,785 [main] org.mule.model.seda.SedaService: Mule Service start has been stopped successfully
INFO 2009-12-17 20:34:51,787 [main] org.mule.transport.vm.VMConnector: Stopping: VMConnector{this=75d709a5, started=true, initialised=true, name='connector.VM.0', disposed=false, numberOfConcurrentTransactedReceivers=4, createMultipleTransactedReceivers=true, connected=true, supportedProtocols=[vm], serviceOverrides=null}
INFO 2009-12-17 20:34:51,787 [main] org.mule.transport.vm.VMConnector: Disconnected: VMConnector{this=75d709a5, started=false, initialised=true, name='connector.VM.0', disposed=false, numberOfConcurrentTransactedReceivers=4, createMultipleTransactedReceivers=true, connected=false, supportedProtocols=[vm], serviceOverrides=null}
INFO 2009-12-17 20:34:51,787 [main] org.mule.transport.vm.VMConnector: Stopped: VMConnector{this=75d709a5, started=false, initialised=true, name='connector.VM.0', disposed=false, numberOfConcurrentTransactedReceivers=4, createMultipleTransactedReceivers=true, connected=false, supportedProtocols=[vm], serviceOverrides=null}
INFO 2009-12-17 20:34:51,788 [main] org.mule.util.queue.TransactionalQueueManager: Stopping ResourceManager
INFO 2009-12-17 20:34:51,788 [main] org.mule.util.queue.TransactionalQueueManager: Stopped ResourceManager
INFO 2009-12-17 20:34:51,788 [main] org.mule.transport.vm.VMConnector: Disposing: VMConnector{this=75d709a5, started=false, initialised=true, name='connector.VM.0', disposed=false, numberOfConcurrentTransactedReceivers=4, createMultipleTransactedReceivers=true, connected=false, supportedProtocols=[vm], serviceOverrides=null}
INFO 2009-12-17 20:34:51,788 [main] org.mule.transport.vm.VMMessageDispatcher: Disconnected: VMMessageDispatcher{this=1915470e, endpoint=vm://msg-in, disposed=false}
INFO 2009-12-17 20:34:51,788 [main] org.mule.transport.vm.VMConnector: Disposed: VMConnector{this=75d709a5, started=false, initialised=false, name='connector.VM.0', disposed=true, numberOfConcurrentTransactedReceivers=4, createMultipleTransactedReceivers=true, connected=false, supportedProtocols=[vm], serviceOverrides=null}
INFO 2009-12-17 20:34:51,789 [main] org.mule.config.spring.MuleApplicationContext: Closing org.mule.config.spring.MuleApplicationContext@356f144c: display name [org.mule.config.spring.MuleApplicationContext@356f144c]; startup date [Thu Dec 17 20:34:49 CET 2009]; root of context hierarchy
INFO 2009-12-17 20:34:51,789 [main] org.springframework.beans.factory.support.DefaultListableBeanFactory: Destroying singletons in org.springframework.beans.factory.support.DefaultListableBeanFactory@29abc69: defining beans [customEditorConfigurer,_muleObjectNameProcessor,_mulePropertyPlaceholderProcessor, _muleSimpleRegistryBootstrap,_muleNotificationManager,_muleConfiguration,._muleNotificationManager: notification.1,._muleNotificationManager:notification.2,._muleNotificationManager:notification.3, ._muleNotificationManager:notification.4,._muleNotificationManager:notification.5,._muleNotificationManager: notification.6,._muleNotificationManager:notification.7,._muleNotificationManager:notification.8, ._muleNotificationManager:notification.9,._muleNotificationManager:notification.10,_muleSystemModel, _muleQueueManager,_muleSecurityManager,_muleProperties,_muleEndpointFactory,_muleStreamCloserService, _defaultThreadingProfile,_defaultMessageDispatcherThreadingProfile,_defaultMessageRequesterThreadingProfile, _defaultMessageReceiverThreadingProfile,_defaultServiceThreadingProfile,_defaultRetryPolicyTemplate, mule-ode,start,.start:inbound.11,.start:inbound.11:inbound-endpoint.12,.start:component.13]; root of factory hierarchy
INFO 2009-12-17 20:34:51,995 [main] org.mule.DefaultMuleContext:
**********************************************************************
* Mule shut down normally on: 12/17/09 8:34 PM *
* Server was up for: 0 days, 0 hours, 0 mins, 1.318 sec *
**********************************************************************
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 3.103 sec

So by finishing this post you should be able to execute a (simple) BPEL process in Apache ODE by using Mule. However, it is not certain we will use Apache ODE like this. I think we would like Intalio|server more because of the handy features/tooling they have added to Apache ODE.

]]> http://blog.redstream.nl/2009/12/18/combining-mule-with-a-bpel-engine/feed/ 0