Async Binary Update Sample

This sample provides a design pattern that is appropriate when the application architecture requires a binary message to be processed from a JMS provider. For convenience in testing, a reply queue is used, although that is not mandated by the pattern.

Note: This sample is provided on dev2dev for your convenience and is not supported by BEA.

What the Sample Does

The sample consists of a single WebLogic Integration application containing an asynchronous business process (a JPD), a standalone java client, and associated artifacts including WSDL, Process Control, and Schema. The client invokes the JPD by sending non-XML data through a JMS queue. A user-provided message driven bean (MDB) consumes the JMS message and calls a JPD using a JPD proxy. The non-XML data is converted to XML, the XML is persisted for future reference, and then forwarded for further processing. XML data with a validation code is returned, persisted, converted to non-XML format, and then received by the client through a JMS reply queue.

How It Works

As the architecture diagram below illustrates, an MDB listens for the incoming message, converts it to XML on arrival, and calls the JPD for further processing. Upon completion of the process, an outbound XML message is created and sent to an outbound message handler that converts it to non-XML format before sending it to the client.

The JMS client invokes the JPD by sending it a non-XML data message. Based on the contents of the message header, the JPD determines where to send the message for further processing. Upon completion of the process, the JPD returns a message to a handler, which sends it to the client.

Required Software

This sample requires the following software:

• WebLogic Integration 8.1, SP4 or later (includes Jython 2.1). You can download WebLogic Integration 8.1 from the download page on dev2dev.
• WLI Common Utilities, version 2.5. You can download WLI Common Utilities from the download page.
• WebLogic Server Scripting Tool (WLST) (included with WLI Common Utilities). You can also download WLST from the download page.
• Note: WLST Offline and WLST Online are available for download and evaluation from BEA's dev2dev site, but have not been formally included in the WebLogic Platform 8.1 product. WLST is supported through BEA newsgroups only, and the utility and APIs are subject to change. BEA intends to formally support this capability in a future release of WebLogic Platform.

Notes

Variants in this pattern may include:

• Using a foreign JMS Provider such as IBM MQ Series. See Using Foreign JMS Providers with WebLogic Server for details.
• Using the WLI JMS event generator rather than a user-provided MDB.

Supporting Materials

In addition to providing application code, the sample includes the following items:

• Instructions and scripts for creating a Java client using ant are provided to act as a WebSphere MQ
• Instructions and scripts for configuring a BEA WebLogic Integration cluster to support the application
• Instructions and scripts for deploying the application to an appropriately configured cluster
• Instructions, guidelines, and caveats for designing asynchronous processes for client interactions

How to Download

You can download the Async Binary Update sample and WLI Common Utilities from the download page on dev2dev.