org.apache.activemq.store.jdbc

Class JDBCTopicMessageStore

java.lang.Object

org.apache.activemq.store.AbstractMessageStore

org.apache.activemq.store.jdbc.JDBCMessageStore

org.apache.activemq.store.jdbc.JDBCTopicMessageStore

All Implemented Interfaces:

Service, MessageStore, TopicMessageStore

public class JDBCTopicMessageStore
extends JDBCMessageStore
implements TopicMessageStore

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROPERTY_SEQUENCE_ID_CACHE_SIZE

Fields inherited from class org.apache.activemq.store.jdbc.JDBCMessageStore

adapter, audit, lastRecoveredPriority, lastRecoveredSequenceId, persistenceAdapter, wireFormat

Fields inherited from class org.apache.activemq.store.AbstractMessageStore

destination, FUTURE, prioritizedMessages

Constructor Summary

Constructors

Constructor and Description
JDBCTopicMessageStore(JDBCPersistenceAdapter persistenceAdapter, JDBCAdapter adapter, WireFormat wireFormat, ActiveMQTopic topic, ActiveMQMessageAudit audit)

Method Summary

Methods

Modifier and Type	Method and Description
void	acknowledge(ConnectionContext context, java.lang.String clientId, java.lang.String subscriptionName, MessageId messageId, MessageAck ack) Stores the last acknowledged messgeID for the given subscription so that we can recover and commence dispatching messages from the last checkpoint
void	addSubsciption(SubscriptionInfo subscriptionInfo, boolean retroactive) Inserts the subscriber info due to a subscription change If this is a new subscription and the retroactive is false, then the last message sent to the topic should be set as the last message acknowledged by they new subscription.
void	deleteSubscription(java.lang.String clientId, java.lang.String subscriptionName)
SubscriptionInfo[]	getAllSubscriptions() Lists all the durable subscriptions for a given destination.
int	getMessageCount(java.lang.String clientId, java.lang.String subscriberName) Get the number of messages ready to deliver from the store to a durable subscriber
protected java.lang.String	getSubscriptionKey(java.lang.String clientId, java.lang.String subscriberName)
SubscriptionInfo	lookupSubscription(java.lang.String clientId, java.lang.String subscriptionName) Finds the subscriber entry for the given consumer info
protected void	onAdd(MessageId messageId, long sequenceId, byte priority)
void	recoverNextMessages(java.lang.String clientId, java.lang.String subscriptionName, int maxReturned, MessageRecoveryListener listener) For an active subscription - retrieve messages from the store for the subscriber after the lastMessageId messageId
void	recoverSubscription(java.lang.String clientId, java.lang.String subscriptionName, MessageRecoveryListener listener) For the new subscription find the last acknowledged message ID and then find any new messages since then and dispatch them to the subscription.
void	resetBatching(java.lang.String clientId, java.lang.String subscriptionName) A hint to the Store to reset any batching state for a durable subsriber

Methods inherited from class org.apache.activemq.store.jdbc.JDBCMessageStore

addMessage, addMessageReference, getMessage, getMessageCount, getMessageReference, recover, recoverNextMessages, removeAllMessages, removeMessage, resetBatching, setBatch, setPrioritizedMessages

Methods inherited from class org.apache.activemq.store.AbstractMessageStore

addMessage, asyncAddQueueMessage, asyncAddQueueMessage, asyncAddTopicMessage, asyncAddTopicMessage, dispose, getDestination, isEmpty, isPrioritizedMessages, removeAsyncMessage, setMemoryUsage, start, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.activemq.store.MessageStore

addMessage, addMessage, asyncAddQueueMessage, asyncAddQueueMessage, asyncAddTopicMessage, asyncAddTopicMessage, dispose, getDestination, getMessage, getMessageCount, isEmpty, isPrioritizedMessages, recover, recoverNextMessages, removeAllMessages, removeAsyncMessage, removeMessage, resetBatching, setBatch, setMemoryUsage, setPrioritizedMessages

Methods inherited from interface org.apache.activemq.Service

start, stop

Field Detail

PROPERTY_SEQUENCE_ID_CACHE_SIZE

public static final java.lang.String PROPERTY_SEQUENCE_ID_CACHE_SIZE

See Also:

Constant Field Values

Constructor Detail

JDBCTopicMessageStore

public JDBCTopicMessageStore(JDBCPersistenceAdapter persistenceAdapter,
                     JDBCAdapter adapter,
                     WireFormat wireFormat,
                     ActiveMQTopic topic,
                     ActiveMQMessageAudit audit)
                      throws java.io.IOException

Throws:

java.io.IOException

Method Detail

acknowledge

public void acknowledge(ConnectionContext context,
               java.lang.String clientId,
               java.lang.String subscriptionName,
               MessageId messageId,
               MessageAck ack)
                 throws java.io.IOException

Description copied from interface: TopicMessageStore

Stores the last acknowledged messgeID for the given subscription so that we can recover and commence dispatching messages from the last checkpoint

Specified by:

acknowledge in interface TopicMessageStore

Throws:

java.io.IOException

recoverSubscription

public void recoverSubscription(java.lang.String clientId,
                       java.lang.String subscriptionName,
                       MessageRecoveryListener listener)
                         throws java.lang.Exception

Description copied from interface: TopicMessageStore

For the new subscription find the last acknowledged message ID and then find any new messages since then and dispatch them to the subscription.

e.g. if we dispatched some messages to a new durable topic subscriber, then went down before acknowledging any messages, we need to know the correct point from which to recover from.

Specified by:

recoverSubscription in interface TopicMessageStore

Throws:

java.lang.Exception

recoverNextMessages

public void recoverNextMessages(java.lang.String clientId,
                       java.lang.String subscriptionName,
                       int maxReturned,
                       MessageRecoveryListener listener)
                         throws java.lang.Exception

Description copied from interface: TopicMessageStore

For an active subscription - retrieve messages from the store for the subscriber after the lastMessageId messageId

Specified by:

recoverNextMessages in interface TopicMessageStore

Throws:

java.lang.Exception

resetBatching

public void resetBatching(java.lang.String clientId,
                 java.lang.String subscriptionName)

Description copied from interface: TopicMessageStore

A hint to the Store to reset any batching state for a durable subsriber

Specified by:

resetBatching in interface TopicMessageStore

onAdd

protected void onAdd(MessageId messageId,
         long sequenceId,
         byte priority)

Overrides:

onAdd in class JDBCMessageStore

addSubsciption

public void addSubsciption(SubscriptionInfo subscriptionInfo,
                  boolean retroactive)
                    throws java.io.IOException

Description copied from interface: TopicMessageStore

Inserts the subscriber info due to a subscription change

If this is a new subscription and the retroactive is false, then the last message sent to the topic should be set as the last message acknowledged by they new subscription. Otherwise, if retroactive is true, then create the subscription without it having an acknowledged message so that on recovery, all message recorded for the topic get replayed.

Specified by:

addSubsciption in interface TopicMessageStore

Throws:

java.io.IOException

lookupSubscription

public SubscriptionInfo lookupSubscription(java.lang.String clientId,
                                  java.lang.String subscriptionName)
                                    throws java.io.IOException

Description copied from interface: TopicMessageStore

Finds the subscriber entry for the given consumer info

Specified by:

lookupSubscription in interface TopicMessageStore

Returns:

the SubscriptionInfo

Throws:

java.io.IOException

See Also:

TopicMessageStore.lookupSubscription(String, String)

deleteSubscription

public void deleteSubscription(java.lang.String clientId,
                      java.lang.String subscriptionName)
                        throws java.io.IOException

Specified by:

deleteSubscription in interface TopicMessageStore

Throws:

java.io.IOException

getAllSubscriptions

public SubscriptionInfo[] getAllSubscriptions()
                                       throws java.io.IOException

Description copied from interface: TopicMessageStore

Lists all the durable subscriptions for a given destination.

Specified by:

getAllSubscriptions in interface TopicMessageStore

Returns:

an array SubscriptionInfos

Throws:

java.io.IOException

getMessageCount

public int getMessageCount(java.lang.String clientId,
                  java.lang.String subscriberName)
                    throws java.io.IOException

Description copied from interface: TopicMessageStore

Get the number of messages ready to deliver from the store to a durable subscriber

Specified by:

getMessageCount in interface TopicMessageStore

Returns:

the outstanding message count

Throws:

java.io.IOException

getSubscriptionKey

protected java.lang.String getSubscriptionKey(java.lang.String clientId,
                                  java.lang.String subscriberName)