org.exolab.jms.messagemgr
Interface InternalMessageListener

All Known Implementing Classes:

JmsServerSession

public interface InternalMessageListener

This is the server side implementation of a message listener

Version:

$Revision: 1.4 $ $Date: 2003/08/07 13:33:03 $

Author:

Jim Alateras

Method Summary

void	onMessage(MessageHandle message, boolean ack) Send the specified message to the client.
void	onMessageAvailable(long clientId) Inform the session that there is a message available for the message consumer with the specified identity
void	onMessages(java.util.Vector messages) Send the specified collection of messages to the client

Method Detail

onMessage

public void onMessage(MessageHandle message,
                      boolean ack)
               throws java.lang.Exception

Send the specified message to the client. If the ack paramter is set then comply to the acking policy of the session. If this parameter is not set then ignore the acking policy. The later mode is used by the queue browser, when it sends messages

Parameters:

message - - message handle

ack - - false ignores the acking policy

Throws:

java.lang.Exception - - propagate exceptions to client

onMessages

public void onMessages(java.util.Vector messages)
                throws java.lang.Exception

Send the specified collection of messages to the client

Parameters:

messages - - collection of MessageHandle objects

Throws:

java.lang.Exception - - propagate exceptions to client

onMessageAvailable

public void onMessageAvailable(long clientId)
                        throws java.lang.Exception

Inform the session that there is a message available for the message consumer with the specified identity

Parameters:

clientId - - the identity of the client