org.exolab.jms.messagemgr
Interface MessageManagerEventListener

All Known Implementing Classes:

DestinationCache, DestinationManager

public interface MessageManagerEventListener

A MessageManagerEventListener responds to events generated by the MessageMgr.

It gets notified when a message is added or removed for a particular destination.

Additionally, the message listener is scoped so that it only receives messages for a particular destination

Version:

$Revision: 1.5 $ $Date: 2003/08/17 01:32:24 $

Author:

Jim Alateras

Method Summary

boolean	messageAdded(JmsDestination destination, MessageImpl message) This method is called when the MessageMgr adds a message for this destination to the cache
void	messageRemoved(JmsDestination destination, MessageImpl message) This method is called when the MessageMgr removes a message from the cache.
boolean	persistentMessageAdded(java.sql.Connection connection, JmsDestination destination, MessageImpl message) This event is called when the MessageMgr adds a persistent message to the cache.
void	persistentMessageRemoved(java.sql.Connection connection, JmsDestination destination, MessageImpl message) This event is called when the MessageMgr removes a persistent message from the cache.

Method Detail

messageAdded

public boolean messageAdded(JmsDestination destination,
                            MessageImpl message)

This method is called when the MessageMgr adds a message for this destination to the cache

Parameters:

destination - the message's destination

message - the message added to cache

Returns:

true if this message was accepted

messageRemoved

public void messageRemoved(JmsDestination destination,
                           MessageImpl message)

This method is called when the MessageMgr removes a message from the cache.

Parameters:

destination - the message's destination

message - message removed from cache

persistentMessageAdded

public boolean persistentMessageAdded(java.sql.Connection connection,
                                      JmsDestination destination,
                                      MessageImpl message)
                               throws PersistenceException

This event is called when the MessageMgr adds a persistent message to the cache.

Parameters:

connection - the database connection

destination - the message's destination

message - message added to cache

Returns:

trueThrows:

PersistenceException - if there is a persistence related problem

persistentMessageRemoved

public void persistentMessageRemoved(java.sql.Connection connection,
                                     JmsDestination destination,
                                     MessageImpl message)
                              throws PersistenceException

This event is called when the MessageMgr removes a persistent message from the cache.

Parameters:

connection - the database connection

message - message to remove from cache

destination - the message's destination

Throws:

PersistenceException - - if there is a persistence related problem