org.activemq.store.jdbc
Class JDBCTopicMessageStore

java.lang.Object
  org.activemq.store.jdbc.JDBCMessageStore
      org.activemq.store.jdbc.JDBCTopicMessageStore

All Implemented Interfaces:

Service, MessageStore, TopicMessageStore

public class JDBCTopicMessageStore
extends JDBCMessageStore
implements TopicMessageStore

Version:

$Revision: 1.1 $

Field Summary

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

adapter, destinationName, persistenceAdapter, sequenceGenerator, wireFormat

Constructor Summary

JDBCTopicMessageStore(JDBCPersistenceAdapter persistenceAdapter, JDBCAdapter adapter, WireFormat wireFormat, String destinationName)

Method Summary

void	decrementMessageCountAndMaybeDelete(MessageIdentity messageIdentity) Decrement the reference count of this message ID and if there are no more references then delete the message from persistent store (or maybe archive it off somewhere)
void	deleteSubscription(String subscription)
MessageIdentity	getLastestMessageIdentity() Returns the last message identity that was delivered on this container which can then be used as a checkpoint so that when new durable consumers start, we know where to checkpoint their subscriptions.
SubscriberEntry	getSubscriberEntry(ConsumerInfo info) Finds the subscriber entry for the given consumer info
void	incrementMessageCount(MessageIdentity messageId) Increments the reference count of the message ID as its been dispatched to another subscriber.
void	recoverSubscription(String subscriptionId, MessageIdentity lastDispatchedMessage, RecoveryListener listener) For the new subcription find the last acknowledged message ID and then find any new messages since then and dispatch them to the subscription.
void	setLastAcknowledgedMessageIdentity(String subscription, MessageIdentity messageIdentity) Stores the last acknowledged messgeID for the given subscription so that we can recover and commence dispatching messages from the last checkpoint
void	setSubscriberEntry(ConsumerInfo info, SubscriberEntry subscriberEntry) Inserts or updates the subscriber info due to a subscription change

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

addMessage, getMessage, getMessageSequenceId, recover, removeAllMessages, removeMessage, 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.activemq.store.MessageStore

addMessage, getMessage, recover, removeAllMessages, removeMessage

Methods inherited from interface org.activemq.service.Service

start, stop

Constructor Detail

JDBCTopicMessageStore

public JDBCTopicMessageStore(JDBCPersistenceAdapter persistenceAdapter,
                             JDBCAdapter adapter,
                             WireFormat wireFormat,
                             String destinationName)

Method Detail

setLastAcknowledgedMessageIdentity

public void setLastAcknowledgedMessageIdentity(String subscription,
                                               MessageIdentity messageIdentity)
                                        throws JMSException

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:

setLastAcknowledgedMessageIdentity in interface TopicMessageStore

Throws:

JMSException

getLastestMessageIdentity

public MessageIdentity getLastestMessageIdentity()
                                          throws JMSException

Description copied from interface: TopicMessageStore

Returns the last message identity that was delivered on this container which can then be used as a checkpoint so that when new durable consumers start, we know where to checkpoint their subscriptions.

Note that this method does not need to return a valid messageID, purely the sequence number.

Specified by:

getLastestMessageIdentity in interface TopicMessageStore

Returns:

the last message identity which was persisted in the durable store or null if the store is empty.

Throws:

JMSException

See Also:

TopicMessageStore.getLastestMessageIdentity()

recoverSubscription

public void recoverSubscription(String subscriptionId,
                                MessageIdentity lastDispatchedMessage,
                                RecoveryListener listener)
                         throws JMSException

Description copied from interface: TopicMessageStore

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

If this is a new subscription then the lastDispatchMessage should be written to the acknowledgement table to write a checkpoint so that when we recover we will start from the correct point.

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:

JMSException

setSubscriberEntry

public void setSubscriberEntry(ConsumerInfo info,
                               SubscriberEntry subscriberEntry)
                        throws JMSException

Description copied from interface: TopicMessageStore

Inserts or updates the subscriber info due to a subscription change

Specified by:

setSubscriberEntry in interface TopicMessageStore

Throws:

JMSException

See Also:

TopicMessageStore.setSubscriberEntry(org.activemq.message.ConsumerInfo, org.activemq.service.SubscriberEntry)

getSubscriberEntry

public SubscriberEntry getSubscriberEntry(ConsumerInfo info)
                                   throws JMSException

Description copied from interface: TopicMessageStore

Finds the subscriber entry for the given consumer info

Specified by:

getSubscriberEntry in interface TopicMessageStore

Returns:

Throws:

JMSException

See Also:

TopicMessageStore.getSubscriberEntry(org.activemq.message.ConsumerInfo)

deleteSubscription

public void deleteSubscription(String subscription)
                        throws JMSException

Specified by:

deleteSubscription in interface TopicMessageStore

Throws:

JMSException

incrementMessageCount

public void incrementMessageCount(MessageIdentity messageId)
                           throws JMSException

Description copied from interface: TopicMessageStore

Increments the reference count of the message ID as its been dispatched to another subscriber.

Specified by:

incrementMessageCount in interface TopicMessageStore

Throws:

JMSException

decrementMessageCountAndMaybeDelete

public void decrementMessageCountAndMaybeDelete(MessageIdentity messageIdentity)
                                         throws JMSException

Description copied from interface: TopicMessageStore

Decrement the reference count of this message ID and if there are no more references then delete the message from persistent store (or maybe archive it off somewhere)

Specified by:

decrementMessageCountAndMaybeDelete in interface TopicMessageStore

Throws:

JMSException