com.boylesoftware.cb2
Interface BroadcastMessagingTerminal

All Superinterfaces:

java.util.EventListener

All Known Implementing Classes:

ApplicationContext

public interface BroadcastMessagingTerminal

extends java.util.EventListener

CB2 Broadcast Messaging clients (the BCM terminals) implement this interface and register within the application context under specific BCM channel names to receive broadcast messages.

Version:

$Id: BroadcastMessagingTerminal.java,v 1.3 2004/04/16 21:43:27 levahim Exp $

Author:

Lev Himmelfarb

See Also:

ApplicationContext.registerBCMTerminal(java.lang.String, com.boylesoftware.cb2.BroadcastMessagingTerminal)

Method Summary

void	processMessage(java.lang.String channelName, java.lang.String source, java.io.Serializable messageParam) This method gets called when a message is received.

Method Detail

processMessage

public void processMessage(java.lang.String channelName,
                           java.lang.String source,
                           java.io.Serializable messageParam)
                    throws ApplicationException

This method gets called when a message is received.

The method should be written thread-safe, because the framework may let multiple threads into this method at the same time.

Parameters:

channelName - name of the BCM channel, on which the message was received.

source - a string, which identifies in a specific to the BCM provider implementation way the JVM that sent the message.

messageParam - optional general purpose parameter sent along with the message, may be null.

Throws:

ApplicationException - if the was a serious error during the message processing. This exception goes directly to the BCM provider, which called application context's processBCMMessage method to deliver the message to the terminal.