JBoss.orgCommunity Documentation

Chapter 2. Examples

2.1. Overview
2.2. Quickstart Examples - Hello World
2.3. ESB Examples - ESB Invocation of Hello World
2.4. Importing Examples into Eclipse

This chapter provides a getting started guide to the examples. Further information on the individual examples can be found in the samples folder.

If using the Eclipse BPEL editor, bundled with JBoss Tools, then you can import the quickstart samples as Eclipse BPEL projects, by selecting the import menu item on the left navigation panel in Eclipse, and choosing the General->Existing Projects into Workspace option. Then select the individual sample you wish to import, or alternatively select the ${RiftSaw}/samples/quickstart folder to select multiple (or all) samples for import. Please see the RiftSaw User Guide for information on how to deploy the BPEL samples to the server.

Before deploying any of the examples, you need to start the JBossAS server and ensure that RiftSaw has been installed. This can be achieved by testing whether the BPEL Console (as discussed in the User Guide) is available.

The BPEL example we are going to try out is the simple 'hello world' example. This is located in the ${RiftSaw}/samples/quickstarts/hello_world folder.

The first step is to deploy the example to the running JBossAS server. This is achieved using the following command:

ant deploy

When the ant script indicates that it has completed successfully, the next step is to invoke the BPEL process we have just deployed.

This can be achieved using either the supplied ant script,

ant sendhello

Or by using any SOAP client, such as SOAPUI (available from http://www.soapui.org/).

The WSDL definition is located in the bpel folder, and can be used to initialise the SOAPUI client. The service location is: http://localhost:8080/Quickstart_hello_worldWS.

An example message can be found in the messages subfolder.

When the message is submitted to the BPEL process, the response received is:

If you then wish to modify the example and deploy a new version, you will need to either update the 'version' property within the build.xml, or specify the version when performing the command, e.g.

ant -Dversion=2 deploy

and similarly when undeploying,

ant -Dversion=2 undeploy


When modifying a previously deployed BPEL deployment, it will be necessary to either undeploy the previous version, or increment the version number. If you attempt to deploy a BPEL deployment unit with the same name as an already deployed unit, then the server will generate an exception.


Currently the version must be specified as a single integer value. Non-numeric values, such as versions expressed in a major.minor.incremental (maven style), will result in an exception when deployed to the server.

This quickstart example demonstrates how an ESB service can directly invoke a BPEL process running inside RiftSaw, as long as RiftSaw and the ESB are co-located in the same JVM, and the invoked BPEL process is deployed to the RiftSaw instance running co-located with the JBossESB.

The example that we are going to use is located in the ${RiftSaw}/samples/esb/bpel_helloworld folder. Also note that the quickstart described in the preceding section, located in the ${RiftSaw}/samples/quickstarts/hello_world must still be deployed. If this example is not deployed, then please follow the instructions in the previous section to deploy the example.

The next step is to deploy the ESB service that will invoke this "hello world" BPEL process. This is achieved by performing the following command in the ${RiftSaw}/samples/esb/bpel_helloworld folder:

ant deploy

Once the ESB service has been successfully deployed, then run the following command:

ant runtest

This command will send the text "Hello World via ESB to BPEL" to the ESB service, which will invoke the BPEL process, which in turn will append "World" to the text and echo it back until it is received by the client application.

For more information on the ESB to RiftSaw integration, please see the User Guide.

The quickstart examples, provided with the RiftSaw distribution, can be imported into an Eclipse environment as BPEL2.0 projects. This enables the BPEL and WSDL to be viewed using Eclipse based editors. Please see the JBoss Tools project for access to appropriate versions of these tools that work with the RiftSaw runtime engine.

Once imported, the BPEL and WSDL artifacts can be viewed by double-clicking the appropriate files.