EMSMessageHandler


Delegate

Declaration

delegate void EMSMessageHandler( 
    object sender, 
    EMSMessageEventArgs args ); 

Purpose

Asynchronously process an arriving message.

Remarks

This delegate provides an asynchronous pathway for receiving messages. The program implements this delegate, and registers it with a MessageConsumer. When a message arrives, the client library raises an event. This delegate processes the event, which presents the message.

EMSMessageHandler receives messages in a .NET programming idiom. In contrast, IMessageListener mimics the way in which JMS provides similar functionality in a Java programming idiom. Programmers may select either idiom—but not both (which would cause duplicate message processing, with undefined behavior).

Parameter
Description
sender
The MessageConsumer object that raised a message event.
args
The event, which contains the message object.

Example 1 Message Event Handler
... 
consumer.MessageHandler += new EMSMessageHandler(handleMsg); 
... 
private void handleMsg(object sender, EMSMessageEventArgs arg) 
{ 
   Message m = arg.Message; 
   Console.WriteLine("Received message: " + m); 
   ... 
} 
... 

Serialization

In compliance with the JMS specification, sessions distribute messages to listeners and event handler delegates in serial (non-concurrent) fashion.

See Also

MessageConsumer

EMSMessageEventArgs


TIBCO Enterprise Message Service™ .NET Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com