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.
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
- 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.
Variants in this pattern may include:
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.