org.exolab.core.messenger
Interface ChannelListener

public interface ChannelListener

An event handler for handling messages on a Channel. A ChannelListener must support at least one of:

• asynchonrous receipt - the listener processes messages sent by Channel.send(java.lang.Object)
• synchronous invocation - the listener handles requests sent by Channel.invoke(java.lang.Object), and returns a response.

Version:

$Revision: 1.3 $ $Date: 2002/02/20 10:23:48 $

Author:

Tim Anderson

See Also:

Channel, Connection

Method Summary

void	closed() Invoked when the channel that this listener is registered with is closed
java.lang.Object	invoke(java.lang.Object request) Process an invocation request, and return a response
void	receive(java.lang.Object message) Process a message sent by Channel.send(java.lang.Object)

Method Detail

receive

public void receive(java.lang.Object message)

Process a message sent by Channel.send(java.lang.Object)

Parameters:

message - the message

invoke

public java.lang.Object invoke(java.lang.Object request)
                        throws java.lang.Exception

Process an invocation request, and return a response

Parameters:

request - the request

Returns:

the response

Throws:

java.lang.Exception - if the handler cannot process the request. This is propagated back to the client.

closed

public void closed()

Invoked when the channel that this listener is registered with is closed