org.apache.activemq.store

Interface MessageStore

All Superinterfaces:

Service

All Known Subinterfaces:

ReferenceStore, TopicMessageStore, TopicReferenceStore

All Known Implementing Classes:

AbstractMessageStore, JDBCMessageStore, JDBCTopicMessageStore, JournalMessageStore, JournalTopicMessageStore, KahaDBStore.KahaDBMessageStore, MemoryMessageStore, MemoryTopicMessageStore, ProxyMessageStore, ProxyTopicMessageStore, TempKahaDBStore.KahaDBMessageStore

public interface MessageStore
extends Service

Represents a message store which is used by the persistent implementations

Method Summary

Methods

Modifier and Type	Method and Description
void	addMessage(ConnectionContext context, Message message) Adds a message to the message store
void	addMessage(ConnectionContext context, Message message, boolean canOptimizeHint) Adds a message to the message store
java.util.concurrent.Future<java.lang.Object>	asyncAddQueueMessage(ConnectionContext context, Message message) Adds a message to the message store
java.util.concurrent.Future<java.lang.Object>	asyncAddQueueMessage(ConnectionContext context, Message message, boolean canOptimizeHint) Adds a message to the message store
java.util.concurrent.Future<java.lang.Object>	asyncAddTopicMessage(ConnectionContext context, Message message) Adds a message to the message store
java.util.concurrent.Future<java.lang.Object>	asyncAddTopicMessage(ConnectionContext context, Message message, boolean canOptimizeHint) Adds a message to the message store
void	dispose(ConnectionContext context)
ActiveMQDestination	getDestination() The destination that the message store is holding messages for.
Message	getMessage(MessageId identity) Looks up a message using either the String messageID or the messageNumber.
int	getMessageCount()
boolean	isEmpty() flag to indicate if the store is empty
boolean	isPrioritizedMessages()
void	recover(MessageRecoveryListener container) Recover any messages to be delivered.
void	recoverNextMessages(int maxReturned, MessageRecoveryListener listener)
void	removeAllMessages(ConnectionContext context) Removes all the messages from the message store.
void	removeAsyncMessage(ConnectionContext context, MessageAck ack)
void	removeMessage(ConnectionContext context, MessageAck ack) Removes a message from the message store.
void	resetBatching() A hint to the Store to reset any batching state for the Destination
void	setBatch(MessageId messageId) allow caching cursors to set the current batch offset when cache is exhausted
void	setMemoryUsage(MemoryUsage memoryUsage)
void	setPrioritizedMessages(boolean prioritizedMessages) A hint to the store to try recover messages according to priority

Methods inherited from interface org.apache.activemq.Service

start, stop

Method Detail

addMessage

void addMessage(ConnectionContext context,
              Message message)
                throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

Throws:

java.io.IOException

addMessage

void addMessage(ConnectionContext context,
              Message message,
              boolean canOptimizeHint)
                throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

canOptimizeHint - - give a hint to the store that the message may be consumed before it hits the disk

Throws:

java.io.IOException

asyncAddQueueMessage

java.util.concurrent.Future<java.lang.Object> asyncAddQueueMessage(ConnectionContext context,
                                                                 Message message)
                                                                   throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

Returns:

a Future to track when this is complete

Throws:

java.io.IOException

java.io.IOException

asyncAddQueueMessage

java.util.concurrent.Future<java.lang.Object> asyncAddQueueMessage(ConnectionContext context,
                                                                 Message message,
                                                                 boolean canOptimizeHint)
                                                                   throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

canOptimizeHint - - give a hint to the store that the message may be consumed before it hits the disk

Returns:

a Future to track when this is complete

Throws:

java.io.IOException

java.io.IOException

asyncAddTopicMessage

java.util.concurrent.Future<java.lang.Object> asyncAddTopicMessage(ConnectionContext context,
                                                                 Message message)
                                                                   throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

Returns:

a Future to track when this is complete

Throws:

java.io.IOException

java.io.IOException

asyncAddTopicMessage

java.util.concurrent.Future<java.lang.Object> asyncAddTopicMessage(ConnectionContext context,
                                                                 Message message,
                                                                 boolean canOptimizeHint)
                                                                   throws java.io.IOException

Adds a message to the message store

Parameters:

context - context

message -

canOptimizeHint - - give a hint to the store that the message may be consumed before it hits the disk

Returns:

a Future to track when this is complete

Throws:

java.io.IOException

java.io.IOException

getMessage

Message getMessage(MessageId identity)
                   throws java.io.IOException

Looks up a message using either the String messageID or the messageNumber. Implementations are encouraged to fill in the missing key if its easy to do so.

Parameters:

identity - which contains either the messageID or the messageNumber

Returns:

the message or null if it does not exist

Throws:

java.io.IOException

removeMessage

void removeMessage(ConnectionContext context,
                 MessageAck ack)
                   throws java.io.IOException

Removes a message from the message store.

Parameters:

context -

ack - the ack request that cause the message to be removed. It conatins the identity which contains the messageID of the message that needs to be removed.

Throws:

java.io.IOException

removeAsyncMessage

void removeAsyncMessage(ConnectionContext context,
                      MessageAck ack)
                        throws java.io.IOException

Throws:

java.io.IOException

removeAllMessages

void removeAllMessages(ConnectionContext context)
                       throws java.io.IOException

Removes all the messages from the message store.

Parameters:

context -

Throws:

java.io.IOException

recover

void recover(MessageRecoveryListener container)
             throws java.lang.Exception

Recover any messages to be delivered.

Parameters:

container -

Throws:

java.lang.Exception

getDestination

ActiveMQDestination getDestination()

The destination that the message store is holding messages for.

Returns:

the destination

setMemoryUsage

void setMemoryUsage(MemoryUsage memoryUsage)

Parameters:

memoryUsage - The SystemUsage that is controlling the destination's memory usage.

getMessageCount

int getMessageCount()
                    throws java.io.IOException

Returns:

the number of messages ready to deliver

Throws:

java.io.IOException

resetBatching

void resetBatching()

A hint to the Store to reset any batching state for the Destination

recoverNextMessages

void recoverNextMessages(int maxReturned,
                       MessageRecoveryListener listener)
                         throws java.lang.Exception

Throws:

java.lang.Exception

dispose

void dispose(ConnectionContext context)

setBatch

void setBatch(MessageId messageId)
              throws java.lang.Exception

allow caching cursors to set the current batch offset when cache is exhausted

Parameters:

messageId -

Throws:

java.lang.Exception

isEmpty

boolean isEmpty()
                throws java.lang.Exception

flag to indicate if the store is empty

Returns:

true if the message count is 0

Throws:

java.lang.Exception

setPrioritizedMessages

void setPrioritizedMessages(boolean prioritizedMessages)

A hint to the store to try recover messages according to priority

Parameters:

prioritizedMessages -

isPrioritizedMessages

boolean isPrioritizedMessages()

Returns:

true if store is trying to recover messages according to priority