13.1 Overview

HydraExpress supports both synchronous and asynchronous messaging. Whether a message is synchronous or asynchronous may be defined at two levels: at the service level or the transport level. For example, the message patterns one-way and notification are inherently asynchronous since they require no return message. However, certain transports (such as HTTP) are inherently synchronous because they require an acknowledgement of receipt, forcing the client proxy to block until this acknowledgement is received.

This chapter discusses creating synchronous and asynchronous messages based on the service level, unless otherwise noted.

In a typical synchronous process, the client sends a request to the server and the server responds. The requestor, or client, blocks and waits for the response. This process works well when the server response is immediate. However, if the response is delayed, client execution must halt until it arrives.

In an asynchronous process, the client can perform other work while waiting for a response that may be delayed. HydraExpress accomplishes this by returning an asynchronous handle that runs a thread in the background, allowing the client to continue execution until the response is ready.

Creating an asynchronous client is easy: you simply build your client using the proxy's provided asynchronous service operation methods rather than the synchronous ones.

As noted above, the one-way and notification message patterns are essentially asynchronous. However, you can use these two patterns together to create an effectively synchronous interaction.

The following sections examine in more detail how to build asynchronous clients for any message pattern, and how to implement the notification and one-way message patterns in your service.

© Copyright Rogue Wave Software, Inc. All Rights Reserved. All Rights Reserved. Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. HydraExpress is a trademark of Rogue Wave Software, Inc. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.