org.apache.activemq.store.rapid
Class RapidTopicMessageStore

java.lang.Object
  extended by org.apache.activemq.store.rapid.RapidMessageStore
      extended by org.apache.activemq.store.rapid.RapidTopicMessageStore
All Implemented Interfaces:
Service, MessageStore, TopicMessageStore

public class RapidTopicMessageStore
extends RapidMessageStore
implements TopicMessageStore

A MessageStore that uses a Journal to store it's messages.

Version:
$Revision: 1.13 $

Field Summary
 
Fields inherited from class org.apache.activemq.store.rapid.RapidMessageStore
destination, inFlightTxLocations, lastLocation, messageContainer, peristenceAdapter, transactionStore, transactionTemplate
 
Constructor Summary
RapidTopicMessageStore(RapidPersistenceAdapter adapter, ActiveMQTopic destination, MapContainer messageContainer, MapContainer subsContainer, MapContainer ackContainer)
           
 
Method Summary
 void acknowledge(ConnectionContext context, java.lang.String clientId, java.lang.String subscriptionName, MessageId messageId)
          Stores the last acknowledged messgeID for the given subscription so that we can recover and commence dispatching messages from the last checkpoint
 void addMessage(ConnectionContext context, Message message)
          Not synchronized since the Journal has better throughput if you increase the number of concurrent writes that it is doing.
 void addSubsciption(java.lang.String clientId, java.lang.String subscriptionName, java.lang.String selector, 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.

protected  void addSubscriberAckContainer(java.lang.Object key)
           
 org.apache.activeio.journal.RecordLocation checkpoint()
           
 void deleteSubscription(java.lang.String clientId, java.lang.String subscriptionName)
           
 SubscriptionInfo[] getAllSubscriptions()
          Lists all the durable subscirptions 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
 MessageId getNextMessageIdToDeliver(java.lang.String clientId, java.lang.String subscriptionName, MessageId messageId)
          Get the next messageId to deliver to a subscriber after the MessageId provided
 MessageId getPreviousMessageIdToDeliver(java.lang.String clientId, java.lang.String subscriptionName, MessageId messageId)
          Get the previous messageId to deliver to a subscriber before the MessageId provided
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
 void recoverNextMessages(java.lang.String clientId, java.lang.String subscriptionName, MessageId lastMessageId, 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 replayAcknowledge(ConnectionContext context, java.lang.String clientId, java.lang.String subscritionName, MessageId messageId)
           
 void resetBatching(java.lang.String clientId, java.lang.String subscriptionName, MessageId nextId)
          A hint to the Store to reset any batching state for a durable subsriber
 
Methods inherited from class org.apache.activemq.store.rapid.RapidMessageStore
addMessageReference, getDestination, getMessage, getMessageReference, recover, removeAllMessages, removeMessage, replayAddMessage, replayRemoveMessage, setUsageManager, start, stop, toRecordLocation, toString
 
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
addMessageReference, getDestination, getMessage, getMessageReference, recover, removeAllMessages, removeMessage, setUsageManager
 
Methods inherited from interface org.apache.activemq.Service
start, stop
 

Constructor Detail

RapidTopicMessageStore

public RapidTopicMessageStore(RapidPersistenceAdapter adapter,
                              ActiveMQTopic destination,
                              MapContainer messageContainer,
                              MapContainer subsContainer,
                              MapContainer ackContainer)
                       throws java.io.IOException
Throws:
java.io.IOException
Method Detail

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,
                                MessageId lastMessageId,
                                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

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

addSubsciption

public void addSubsciption(java.lang.String clientId,
                           java.lang.String subscriptionName,
                           java.lang.String selector,
                           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

addMessage

public void addMessage(ConnectionContext context,
                       Message message)
                throws java.io.IOException
Description copied from class: RapidMessageStore
Not synchronized since the Journal has better throughput if you increase the number of concurrent writes that it is doing.

Specified by:
addMessage in interface MessageStore
Overrides:
addMessage in class RapidMessageStore
Parameters:
context - TODO
Throws:
java.io.IOException

acknowledge

public void acknowledge(ConnectionContext context,
                        java.lang.String clientId,
                        java.lang.String subscriptionName,
                        MessageId messageId)
                 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

replayAcknowledge

public void replayAcknowledge(ConnectionContext context,
                              java.lang.String clientId,
                              java.lang.String subscritionName,
                              MessageId messageId)

getSubscriptionKey

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

checkpoint

public org.apache.activeio.journal.RecordLocation checkpoint()
                                                      throws java.io.IOException
Overrides:
checkpoint in class RapidMessageStore
Returns:
Throws:
java.io.IOException

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 subscirptions for a given destination.

Specified by:
getAllSubscriptions in interface TopicMessageStore
Returns:
an array SubscriptionInfos
Throws:
java.io.IOException

addSubscriberAckContainer

protected void addSubscriberAckContainer(java.lang.Object key)
                                  throws java.io.IOException
Throws:
java.io.IOException

getNextMessageIdToDeliver

public MessageId getNextMessageIdToDeliver(java.lang.String clientId,
                                           java.lang.String subscriptionName,
                                           MessageId messageId)
                                    throws java.io.IOException
Description copied from interface: TopicMessageStore
Get the next messageId to deliver to a subscriber after the MessageId provided

Specified by:
getNextMessageIdToDeliver in interface TopicMessageStore
Returns:
the next messageId or null
Throws:
java.io.IOException

getPreviousMessageIdToDeliver

public MessageId getPreviousMessageIdToDeliver(java.lang.String clientId,
                                               java.lang.String subscriptionName,
                                               MessageId messageId)
                                        throws java.io.IOException
Description copied from interface: TopicMessageStore
Get the previous messageId to deliver to a subscriber before the MessageId provided

Specified by:
getPreviousMessageIdToDeliver in interface TopicMessageStore
Returns:
the next messageId or null
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

resetBatching

public void resetBatching(java.lang.String clientId,
                          java.lang.String subscriptionName,
                          MessageId nextId)
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


Copyright © 2010 Apache Software Foundation. All Rights Reserved.