org.apache.activemq.artemis.core.persistence.impl.journal

Class JournalStorageManager

java.lang.Object

org.apache.activemq.artemis.core.persistence.impl.journal.JournalStorageManager

All Implemented Interfaces:

StorageManager, ActiveMQComponent, IDGenerator

public class JournalStorageManager
extends Object
implements StorageManager

Controls access to the journals and other storage files such as the ones used to store pages and large messages. This class must control writing of any non-transient data, as it is the key point for synchronizing a replicating backup server.

Using this class also ensures that locks are acquired in the right order, avoiding dead-locks.

Notice that, turning on and off replication (on the live server side) is _mostly_ a matter of using ReplicatedJournals instead of regular JournalImpl, and sync the existing data. For details see the Javadoc of #startReplication(ReplicationManager, PagingManager, String, boolean).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JournalStorageManager.AckDescribe
static class	JournalStorageManager.CursorAckRecordEncoding
static class	JournalStorageManager.DeliveryCountUpdateEncoding
static class	JournalStorageManager.DuplicateIDEncoding
protected static class	JournalStorageManager.HeuristicCompletionEncoding
static class	JournalStorageManager.JournalContent
static class	JournalStorageManager.LargeMessageEncoding
protected static class	JournalStorageManager.PageCountPendingImpl
protected static class	JournalStorageManager.PageCountRecord
protected static class	JournalStorageManager.PageCountRecordInc
static class	JournalStorageManager.PageUpdateTXEncoding
static class	JournalStorageManager.PendingLargeMessageEncoding
static class	JournalStorageManager.PersistentQueueBindingEncoding
static class	JournalStorageManager.QueueEncoding
static class	JournalStorageManager.RefEncoding
protected static class	JournalStorageManager.ScheduledDeliveryEncoding
static class	JournalStorageManager.XidEncoding It's public as other classes may want to unparse data on tools

Nested classes/interfaces inherited from interface org.apache.activemq.artemis.core.persistence.StorageManager

StorageManager.LargeMessageExtension

Constructor Summary

Constructors

Constructor and Description
JournalStorageManager(Configuration config, ExecutorFactory executorFactory)
JournalStorageManager(Configuration config, ExecutorFactory executorFactory, IOCriticalErrorListener criticalErrorListener)

Method Summary

Modifier and Type	Method and Description
void	addBytesToLargeMessage(SequentialFile file, long messageId, byte[] bytes)
void	addGrouping(GroupBinding groupBinding)
void	addQueueBinding(long tx, Binding binding)
boolean	addToPage(PagingStore store, ServerMessage msg, Transaction tx, RouteContextList listCtx) Write message to page if we are paging.
void	afterCompleteOperations(IOCallback run)
void	afterPageRead() We need a safeguard in place to avoid too much concurrent IO happening on Paging, otherwise the system may become unresponsive if too many destinations are reading all the same time.
ByteBuffer	allocateDirectBuffer(int size) AIO has an optimized buffer which has a method to release it instead of the way NIO will release data based on GC.
void	beforePageRead() We need a safeguard in place to avoid too much concurrent IO happening on Paging, otherwise the system may become unresponsive if too many destinations are reading all the same time.
void	clearContext()
void	commit(long txID)
void	commit(long txID, boolean lineUpContext)
void	commitBindings(long txID)
void	confirmPendingLargeMessage(long recordID) We don't need messageID now but we are likely to need it we ever decide to support a database
void	confirmPendingLargeMessageTX(Transaction tx, long messageID, long recordID) Confirms that a large message was finished
SequentialFile	createFileForLargeMessage(long messageID, StorageManager.LargeMessageExtension extension) Instantiates a SequentialFile to be used for storing a LargeServerMessage.
LargeServerMessage	createLargeMessage()
LargeServerMessage	createLargeMessage(long id, MessageInternal message) Creates a new LargeMessage with the given id.
void	criticalError(Throwable error)
void	deleteAddressSetting(SimpleString addressMatch)
void	deleteCursorAcknowledge(long ackID)
void	deleteCursorAcknowledgeTransactional(long txID, long ackID)
void	deleteDuplicateID(long recordID)
void	deleteDuplicateIDTransactional(long txID, long recordID)
void	deleteGrouping(long tx, GroupBinding groupBinding)
void	deleteHeuristicCompletion(long id)
void	deleteID(long journalD)
void	deleteIncrementRecord(long txID, long recordID)
void	deleteMessage(long messageID)
void	deletePageComplete(long ackID)
void	deletePageCounter(long txID, long recordID)
void	deletePageTransactional(long recordID)
void	deletePendingPageCounter(long txID, long recordID)
void	deleteQueueBinding(long tx, long queueBindingID)
void	deleteSecurityRoles(SimpleString addressMatch)
void	freeDirectBuffer(ByteBuffer buffer) AIO has an optimized buffer which has a method to release it instead of the way NIO will release data based on GC.
long	generateID()
Journal	getBindingsJournal()
OperationContext	getContext() Get the context associated with the thread for later reuse
long	getCurrentID()
IDGenerator	getIDGenerator()
Journal	getMessageJournal()
Executor	getSingleThreadExecutor()
boolean	isReplicated()
boolean	isStarted()
void	lineUpContext()
JournalLoadInformation	loadBindingJournal(List<QueueBindingInfo> queueBindingInfos, List<GroupingInfo> groupingInfos)
JournalLoadInformation[]	loadInternalOnly() TODO: Is this still being used ?
JournalLoadInformation	loadMessageJournal(PostOffice postOffice, PagingManager pagingManager, ResourceManager resourceManager, Map<Long,QueueBindingInfo> queueInfos, Map<SimpleString,List<Pair<byte[],Long>>> duplicateIDMap, Set<Pair<Long,Long>> pendingLargeMessages, List<PageCountPending> pendingNonTXPageCounter, JournalLoader journalLoader)
static String	md5(File file)
protected static JournalStorageManager.PersistentQueueBindingEncoding	newBindingEncoding(long id, ActiveMQBuffer buffer)
OperationContext	newContext(Executor executor1) It just creates an OperationContext without associating it
protected static PersistedRoles	newSecurityRecord(long id, ActiveMQBuffer buffer)
OperationContext	newSingleThreadContext()
void	pageClosed(SimpleString storeName, int pageNumber)
void	pageDeleted(SimpleString storeName, int pageNumber)
void	pageWrite(PagedMessage message, int pageNumber)
void	persistIdGenerator() Closes the IDGenerator persisting the current record ID.
void	prepare(long txID, Xid xid)
void	readLock() Read lock the StorageManager.
void	readUnLock() Unlock the manager.
List<PersistedAddressSetting>	recoverAddressSettings()
List<PersistedRoles>	recoverPersistedRoles()
void	rollback(long txID)
void	rollbackBindings(long txID)
void	setContext(OperationContext context) Set the context back to the thread
void	start()
void	startReplication(ReplicationManager replicationManager, PagingManager pagingManager, String nodeID, boolean autoFailBack, long initialReplicationSyncTimeout) Starts replication at the live-server side.
void	stop()
void	stop(boolean ioCriticalError)
void	stopReplication() Stops replication by resetting replication-related fields to their 'unreplicated' state.
void	storeAcknowledge(long queueID, long messageID)
void	storeAcknowledgeTransactional(long txID, long queueID, long messageID)
void	storeAddressSetting(PersistedAddressSetting addressSetting)
void	storeCursorAcknowledge(long queueID, PagePosition position)
void	storeCursorAcknowledgeTransactional(long txID, long queueID, PagePosition position)
void	storeDuplicateID(SimpleString address, byte[] duplID, long recordID)
void	storeDuplicateIDTransactional(long txID, SimpleString address, byte[] duplID, long recordID)
long	storeHeuristicCompletion(Xid xid, boolean isCommit)
void	storeID(long journalID, long id) Stores the id from IDManager.
void	storeMessage(ServerMessage message)
void	storeMessageTransactional(long txID, ServerMessage message)
void	storePageCompleteTransactional(long txID, long queueID, PagePosition position)
long	storePageCounter(long txID, long queueID, long value)
long	storePageCounterInc(long queueID, int value)
long	storePageCounterInc(long txID, long queueID, int value)
void	storePageTransaction(long txID, PageTransactionInfo pageTransaction)
long	storePendingCounter(long queueID, long pageID, int inc)
long	storePendingLargeMessage(long messageID)
void	storeReference(long queueID, long messageID, boolean last)
void	storeReferenceTransactional(long txID, long queueID, long messageID)
void	storeSecurityRoles(PersistedRoles persistedRoles)
void	updateDeliveryCount(MessageReference ref)
void	updateDuplicateIDTransactional(long txID, SimpleString address, byte[] duplID, long recordID)
void	updatePageTransaction(long txID, PageTransactionInfo pageTransaction, int depages)
void	updatePageTransaction(PageTransactionInfo pageTransaction, int depages) FIXME Unused
void	updateScheduledDeliveryTime(MessageReference ref)
void	updateScheduledDeliveryTimeTransactional(long txID, MessageReference ref)
void	waitOnOperations() Block until the operations are done.
boolean	waitOnOperations(long timeout) Block until the operations are done.

Methods inherited from class java.lang.Object

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

Constructor Detail

JournalStorageManager

public JournalStorageManager(Configuration config,
                             ExecutorFactory executorFactory)

JournalStorageManager

public JournalStorageManager(Configuration config,
                             ExecutorFactory executorFactory,
                             IOCriticalErrorListener criticalErrorListener)

Method Detail

criticalError

public void criticalError(Throwable error)

Specified by:

criticalError in interface StorageManager

clearContext

public void clearContext()

Specified by:

clearContext in interface StorageManager

isReplicated

public boolean isReplicated()

startReplication

public void startReplication(ReplicationManager replicationManager,
                             PagingManager pagingManager,
                             String nodeID,
                             boolean autoFailBack,
                             long initialReplicationSyncTimeout)
                      throws Exception

Starts replication at the live-server side.

In practice that means 2 things:
(1) all currently existing data must be sent to the backup.
(2) every new persistent information is replicated (sent) to the backup.

To achieve (1), we lock the entire journal while collecting the list of files to send to the backup. The journal does not remain locked during actual synchronization.

To achieve (2), instead of writing directly to instances of JournalImpl, we write to instances of ReplicatedJournal.

At the backup-side replication is handled by ReplicationEndpoint.

Specified by:

startReplication in interface StorageManager

Parameters:

replicationManager -

pagingManager -

Throws:

ActiveMQException

Exception

See Also:

startReplication(org.apache.activemq.artemis.core.replication.ReplicationManager, org.apache.activemq.artemis.core.paging.PagingManager, String, boolean, long)

md5

public static String md5(File file)

stopReplication

public void stopReplication()

Stops replication by resetting replication-related fields to their 'unreplicated' state.

Specified by:

stopReplication in interface StorageManager

getIDGenerator

public IDGenerator getIDGenerator()

waitOnOperations

public final void waitOnOperations()
                            throws Exception

Description copied from interface: StorageManager

Block until the operations are done. Warning: Don't use it inside an ordered executor, otherwise the system may lock up in case of the pools are full

Specified by:

waitOnOperations in interface StorageManager

Throws:

Exception

waitOnOperations

public final boolean waitOnOperations(long timeout)
                               throws Exception

Description copied from interface: StorageManager

Block until the operations are done. Warning: Don't use it inside an ordered executor, otherwise the system may lock up in case of the pools are full

Specified by:

waitOnOperations in interface StorageManager

Throws:

Exception

pageClosed

public void pageClosed(SimpleString storeName,
                       int pageNumber)

Specified by:

pageClosed in interface StorageManager

pageDeleted

public void pageDeleted(SimpleString storeName,
                        int pageNumber)

Specified by:

pageDeleted in interface StorageManager

pageWrite

public void pageWrite(PagedMessage message,
                      int pageNumber)

Specified by:

pageWrite in interface StorageManager

getContext

public OperationContext getContext()

Description copied from interface: StorageManager

Get the context associated with the thread for later reuse

Specified by:

getContext in interface StorageManager

setContext

public void setContext(OperationContext context)

Description copied from interface: StorageManager

Set the context back to the thread

Specified by:

setContext in interface StorageManager

getSingleThreadExecutor

public Executor getSingleThreadExecutor()

newSingleThreadContext

public OperationContext newSingleThreadContext()

Specified by:

newSingleThreadContext in interface StorageManager

newContext

public OperationContext newContext(Executor executor1)

Description copied from interface: StorageManager

It just creates an OperationContext without associating it

Specified by:

newContext in interface StorageManager

afterCompleteOperations

public void afterCompleteOperations(IOCallback run)

Specified by:

afterCompleteOperations in interface StorageManager

generateID

public long generateID()

Specified by:

generateID in interface IDGenerator

getCurrentID

public long getCurrentID()

Specified by:

getCurrentID in interface IDGenerator

createLargeMessage

public LargeServerMessage createLargeMessage()

Specified by:

createLargeMessage in interface StorageManager

addBytesToLargeMessage

public final void addBytesToLargeMessage(SequentialFile file,
                                         long messageId,
                                         byte[] bytes)
                                  throws Exception

Specified by:

addBytesToLargeMessage in interface StorageManager

Throws:

Exception

createLargeMessage

public LargeServerMessage createLargeMessage(long id,
                                             MessageInternal message)
                                      throws Exception

Description copied from interface: StorageManager

Creates a new LargeMessage with the given id.

Specified by:

createLargeMessage in interface StorageManager

message - This is a temporary message that holds the parsed properties. The remoting layer can't create a ServerMessage directly, then this will be replaced.

Returns:

a large message object

Throws:

Exception

storePendingLargeMessage

public long storePendingLargeMessage(long messageID)
                              throws Exception

Throws:

Exception

confirmPendingLargeMessageTX

public void confirmPendingLargeMessageTX(Transaction tx,
                                         long messageID,
                                         long recordID)
                                  throws Exception

Description copied from interface: StorageManager

Confirms that a large message was finished

Specified by:

confirmPendingLargeMessageTX in interface StorageManager

Throws:

Exception

confirmPendingLargeMessage

public void confirmPendingLargeMessage(long recordID)
                                throws Exception

We don't need messageID now but we are likely to need it we ever decide to support a database

Specified by:

confirmPendingLargeMessage in interface StorageManager

Throws:

Exception

storeMessage

public void storeMessage(ServerMessage message)
                  throws Exception

Specified by:

storeMessage in interface StorageManager

Throws:

Exception

storeReference

public void storeReference(long queueID,
                           long messageID,
                           boolean last)
                    throws Exception

Specified by:

storeReference in interface StorageManager

Throws:

Exception

readLock

public void readLock()

Description copied from interface: StorageManager

Read lock the StorageManager. USE WITH CARE!

The main lock is used to write lock the whole manager when starting replication. Sub-systems, say Paging classes, that use locks of their own AND also write through the StorageManager MUST first read lock the storageManager before taking their own locks. Otherwise, we may dead-lock when starting replication sync.

Specified by:

readLock in interface StorageManager

readUnLock

public void readUnLock()

Description copied from interface: StorageManager

Unlock the manager.

Specified by:

readUnLock in interface StorageManager

See Also:

StorageManager.readLock()

storeAcknowledge

public void storeAcknowledge(long queueID,
                             long messageID)
                      throws Exception

Specified by:

storeAcknowledge in interface StorageManager

Throws:

Exception

storeCursorAcknowledge

public void storeCursorAcknowledge(long queueID,
                                   PagePosition position)
                            throws Exception

Specified by:

storeCursorAcknowledge in interface StorageManager

Throws:

Exception

deleteMessage

public void deleteMessage(long messageID)
                   throws Exception

Specified by:

deleteMessage in interface StorageManager

Throws:

Exception

updateScheduledDeliveryTime

public void updateScheduledDeliveryTime(MessageReference ref)
                                 throws Exception

Specified by:

updateScheduledDeliveryTime in interface StorageManager

Throws:

Exception

storeDuplicateID

public void storeDuplicateID(SimpleString address,
                             byte[] duplID,
                             long recordID)
                      throws Exception

Specified by:

storeDuplicateID in interface StorageManager

Throws:

Exception

deleteDuplicateID

public void deleteDuplicateID(long recordID)
                       throws Exception

Specified by:

deleteDuplicateID in interface StorageManager

Throws:

Exception

storeMessageTransactional

public void storeMessageTransactional(long txID,
                                      ServerMessage message)
                               throws Exception

Specified by:

storeMessageTransactional in interface StorageManager

Throws:

Exception

storePageTransaction

public void storePageTransaction(long txID,
                                 PageTransactionInfo pageTransaction)
                          throws Exception

Specified by:

storePageTransaction in interface StorageManager

Throws:

Exception

updatePageTransaction

public void updatePageTransaction(long txID,
                                  PageTransactionInfo pageTransaction,
                                  int depages)
                           throws Exception

Specified by:

updatePageTransaction in interface StorageManager

Throws:

Exception

updatePageTransaction

public void updatePageTransaction(PageTransactionInfo pageTransaction,
                                  int depages)
                           throws Exception

Description copied from interface: StorageManager

FIXME Unused

Specified by:

updatePageTransaction in interface StorageManager

Throws:

Exception

storeReferenceTransactional

public void storeReferenceTransactional(long txID,
                                        long queueID,
                                        long messageID)
                                 throws Exception

Specified by:

storeReferenceTransactional in interface StorageManager

Throws:

Exception

storeAcknowledgeTransactional

public void storeAcknowledgeTransactional(long txID,
                                          long queueID,
                                          long messageID)
                                   throws Exception

Specified by:

storeAcknowledgeTransactional in interface StorageManager

Throws:

Exception

storeCursorAcknowledgeTransactional

public void storeCursorAcknowledgeTransactional(long txID,
                                                long queueID,
                                                PagePosition position)
                                         throws Exception

Specified by:

storeCursorAcknowledgeTransactional in interface StorageManager

Throws:

Exception

storePageCompleteTransactional

public void storePageCompleteTransactional(long txID,
                                           long queueID,
                                           PagePosition position)
                                    throws Exception

Specified by:

storePageCompleteTransactional in interface StorageManager

Throws:

Exception

deletePageComplete

public void deletePageComplete(long ackID)
                        throws Exception

Specified by:

deletePageComplete in interface StorageManager

Throws:

Exception

deleteCursorAcknowledgeTransactional

public void deleteCursorAcknowledgeTransactional(long txID,
                                                 long ackID)
                                          throws Exception

Specified by:

deleteCursorAcknowledgeTransactional in interface StorageManager

Throws:

Exception

deleteCursorAcknowledge

public void deleteCursorAcknowledge(long ackID)
                             throws Exception

Specified by:

deleteCursorAcknowledge in interface StorageManager

Throws:

Exception

storeHeuristicCompletion

public long storeHeuristicCompletion(Xid xid,
                                     boolean isCommit)
                              throws Exception

Specified by:

storeHeuristicCompletion in interface StorageManager

Throws:

Exception

deleteHeuristicCompletion

public void deleteHeuristicCompletion(long id)
                               throws Exception

Specified by:

deleteHeuristicCompletion in interface StorageManager

Throws:

Exception

deletePageTransactional

public void deletePageTransactional(long recordID)
                             throws Exception

Specified by:

deletePageTransactional in interface StorageManager

Throws:

Exception

updateScheduledDeliveryTimeTransactional

public void updateScheduledDeliveryTimeTransactional(long txID,
                                                     MessageReference ref)
                                              throws Exception

Specified by:

updateScheduledDeliveryTimeTransactional in interface StorageManager

Throws:

Exception

prepare

public void prepare(long txID,
                    Xid xid)
             throws Exception

Specified by:

prepare in interface StorageManager

Throws:

Exception

commit

public void commit(long txID)
            throws Exception

Specified by:

commit in interface StorageManager

Throws:

Exception

commitBindings

public void commitBindings(long txID)
                    throws Exception

Specified by:

commitBindings in interface StorageManager

Throws:

Exception

rollbackBindings

public void rollbackBindings(long txID)
                      throws Exception

Specified by:

rollbackBindings in interface StorageManager

Throws:

Exception

commit

public void commit(long txID,
                   boolean lineUpContext)
            throws Exception

Specified by:

commit in interface StorageManager

Throws:

Exception

rollback

public void rollback(long txID)
              throws Exception

Specified by:

rollback in interface StorageManager

Throws:

Exception

storeDuplicateIDTransactional

public void storeDuplicateIDTransactional(long txID,
                                          SimpleString address,
                                          byte[] duplID,
                                          long recordID)
                                   throws Exception

Specified by:

storeDuplicateIDTransactional in interface StorageManager

Throws:

Exception

updateDuplicateIDTransactional

public void updateDuplicateIDTransactional(long txID,
                                           SimpleString address,
                                           byte[] duplID,
                                           long recordID)
                                    throws Exception

Specified by:

updateDuplicateIDTransactional in interface StorageManager

Throws:

Exception

deleteDuplicateIDTransactional

public void deleteDuplicateIDTransactional(long txID,
                                           long recordID)
                                    throws Exception

Specified by:

deleteDuplicateIDTransactional in interface StorageManager

Throws:

Exception

updateDeliveryCount

public void updateDeliveryCount(MessageReference ref)
                         throws Exception

Specified by:

updateDeliveryCount in interface StorageManager

Throws:

Exception

storeAddressSetting

public void storeAddressSetting(PersistedAddressSetting addressSetting)
                         throws Exception

Specified by:

storeAddressSetting in interface StorageManager

Throws:

Exception

recoverAddressSettings

public List<PersistedAddressSetting> recoverAddressSettings()
                                                     throws Exception

Specified by:

recoverAddressSettings in interface StorageManager

Throws:

Exception

recoverPersistedRoles

public List<PersistedRoles> recoverPersistedRoles()
                                           throws Exception

Specified by:

recoverPersistedRoles in interface StorageManager

Throws:

Exception

storeSecurityRoles

public void storeSecurityRoles(PersistedRoles persistedRoles)
                        throws Exception

Specified by:

storeSecurityRoles in interface StorageManager

Throws:

Exception

storeID

public final void storeID(long journalID,
                          long id)
                   throws Exception

Description copied from interface: StorageManager

Stores the id from IDManager.

Specified by:

storeID in interface StorageManager

Throws:

Exception

deleteID

public void deleteID(long journalD)
              throws Exception

Specified by:

deleteID in interface StorageManager

Throws:

Exception

deleteAddressSetting

public void deleteAddressSetting(SimpleString addressMatch)
                          throws Exception

Specified by:

deleteAddressSetting in interface StorageManager

Throws:

Exception

deleteSecurityRoles

public void deleteSecurityRoles(SimpleString addressMatch)
                         throws Exception

Specified by:

deleteSecurityRoles in interface StorageManager

Throws:

Exception

loadMessageJournal

public JournalLoadInformation loadMessageJournal(PostOffice postOffice,
                                                 PagingManager pagingManager,
                                                 ResourceManager resourceManager,
                                                 Map<Long,QueueBindingInfo> queueInfos,
                                                 Map<SimpleString,List<Pair<byte[],Long>>> duplicateIDMap,
                                                 Set<Pair<Long,Long>> pendingLargeMessages,
                                                 List<PageCountPending> pendingNonTXPageCounter,
                                                 JournalLoader journalLoader)
                                          throws Exception

Specified by:

loadMessageJournal in interface StorageManager

Throws:

Exception

addGrouping

public void addGrouping(GroupBinding groupBinding)
                 throws Exception

Specified by:

addGrouping in interface StorageManager

Throws:

Exception

deleteGrouping

public void deleteGrouping(long tx,
                           GroupBinding groupBinding)
                    throws Exception

Specified by:

deleteGrouping in interface StorageManager

Throws:

Exception

addQueueBinding

public void addQueueBinding(long tx,
                            Binding binding)
                     throws Exception

Specified by:

addQueueBinding in interface StorageManager

Throws:

Exception

deleteQueueBinding

public void deleteQueueBinding(long tx,
                               long queueBindingID)
                        throws Exception

Specified by:

deleteQueueBinding in interface StorageManager

Throws:

Exception

storePageCounterInc

public long storePageCounterInc(long txID,
                                long queueID,
                                int value)
                         throws Exception

Specified by:

storePageCounterInc in interface StorageManager

Returns:

the ID with the increment record

Throws:

Exception

storePageCounterInc

public long storePageCounterInc(long queueID,
                                int value)
                         throws Exception

Specified by:

storePageCounterInc in interface StorageManager

Returns:

the ID with the increment record

Throws:

Exception

storePageCounter

public long storePageCounter(long txID,
                             long queueID,
                             long value)
                      throws Exception

Specified by:

storePageCounter in interface StorageManager

Returns:

The ID with the stored counter

Throws:

Exception

storePendingCounter

public long storePendingCounter(long queueID,
                                long pageID,
                                int inc)
                         throws Exception

Specified by:

storePendingCounter in interface StorageManager

Throws:

Exception

deleteIncrementRecord

public void deleteIncrementRecord(long txID,
                                  long recordID)
                           throws Exception

Specified by:

deleteIncrementRecord in interface StorageManager

Throws:

Exception

deletePageCounter

public void deletePageCounter(long txID,
                              long recordID)
                       throws Exception

Specified by:

deletePageCounter in interface StorageManager

Throws:

Exception

deletePendingPageCounter

public void deletePendingPageCounter(long txID,
                                     long recordID)
                              throws Exception

Specified by:

deletePendingPageCounter in interface StorageManager

Throws:

Exception

loadBindingJournal

public JournalLoadInformation loadBindingJournal(List<QueueBindingInfo> queueBindingInfos,
                                                 List<GroupingInfo> groupingInfos)
                                          throws Exception

Specified by:

loadBindingJournal in interface StorageManager

Throws:

Exception

lineUpContext

public void lineUpContext()

Specified by:

lineUpContext in interface StorageManager

start

public void start()
           throws Exception

Specified by:

start in interface ActiveMQComponent

Throws:

Exception

stop

public void stop()
          throws Exception

Specified by:

stop in interface ActiveMQComponent

Throws:

Exception

persistIdGenerator

public void persistIdGenerator()

Description copied from interface: StorageManager

Closes the IDGenerator persisting the current record ID.

Effectively a "pre-stop" method. Necessary due to the "stop"-order at ActiveMQServerImpl

Specified by:

persistIdGenerator in interface StorageManager

stop

public void stop(boolean ioCriticalError)
          throws Exception

Specified by:

stop in interface StorageManager

Parameters:

ioCriticalError - is the server being stopped due to an IO critical error

Throws:

Exception

isStarted

public boolean isStarted()

Specified by:

isStarted in interface ActiveMQComponent

loadInternalOnly

public JournalLoadInformation[] loadInternalOnly()
                                          throws Exception

TODO: Is this still being used ?

Throws:

Exception

beforePageRead

public void beforePageRead()
                    throws Exception

Description copied from interface: StorageManager

We need a safeguard in place to avoid too much concurrent IO happening on Paging, otherwise the system may become unresponsive if too many destinations are reading all the same time. This is called before we read, so we can limit concurrent reads

Specified by:

beforePageRead in interface StorageManager

Throws:

Exception

afterPageRead

public void afterPageRead()
                   throws Exception

Description copied from interface: StorageManager

We need a safeguard in place to avoid too much concurrent IO happening on Paging, otherwise the system may become unresponsive if too many destinations are reading all the same time. This is called after we read, so we can limit concurrent reads

Specified by:

afterPageRead in interface StorageManager

Throws:

Exception

allocateDirectBuffer

public ByteBuffer allocateDirectBuffer(int size)

Description copied from interface: StorageManager

AIO has an optimized buffer which has a method to release it instead of the way NIO will release data based on GC. These methods will use that buffer if the inner method supports it

Specified by:

allocateDirectBuffer in interface StorageManager

freeDirectBuffer

public void freeDirectBuffer(ByteBuffer buffer)

Description copied from interface: StorageManager

AIO has an optimized buffer which has a method to release it instead of the way NIO will release data based on GC. These methods will use that buffer if the inner method supports it

Specified by:

freeDirectBuffer in interface StorageManager

getMessageJournal

public Journal getMessageJournal()

Specified by:

getMessageJournal in interface StorageManager

Returns:

the message journal

getBindingsJournal

public Journal getBindingsJournal()

Specified by:

getBindingsJournal in interface StorageManager

Returns:

the bindings journal

createFileForLargeMessage

public SequentialFile createFileForLargeMessage(long messageID,
                                                StorageManager.LargeMessageExtension extension)

Description copied from interface: StorageManager

Instantiates a SequentialFile to be used for storing a LargeServerMessage.

Specified by:

createFileForLargeMessage in interface StorageManager

Parameters:

messageID - the id of the message

extension - the extension to add to the file

Returns:

newSecurityRecord

protected static PersistedRoles newSecurityRecord(long id,
                                                  ActiveMQBuffer buffer)

Parameters:

id -

buffer -

Returns:

newBindingEncoding

protected static JournalStorageManager.PersistentQueueBindingEncoding newBindingEncoding(long id,
                                                                                         ActiveMQBuffer buffer)

Parameters:

id -

buffer -

Returns:

addToPage

public boolean addToPage(PagingStore store,
                         ServerMessage msg,
                         Transaction tx,
                         RouteContextList listCtx)
                  throws Exception

Description copied from interface: StorageManager

Write message to page if we are paging.

This is primarily a PagingStore call, but as with any other call writing persistent data, it must go through here. Both for the sake of replication, and also to ensure that it takes the locks (storage manager and pagingStore) in the right order. Avoiding thus the creation of dead-locks.

Specified by:

addToPage in interface StorageManager

Returns:

true if we are paging and have handled the data, false if the data needs to be sent to the journal

Throws:

Exception