org.apache.activemq.broker.region.cursors

Class AbstractStoreCursor

java.lang.Object

org.apache.activemq.broker.region.cursors.AbstractPendingMessageCursor

org.apache.activemq.broker.region.cursors.AbstractStoreCursor

All Implemented Interfaces:

PendingMessageCursor, org.apache.activemq.Service, MessageRecoveryListener

public abstract class AbstractStoreCursor
extends AbstractPendingMessageCursor
implements MessageRecoveryListener

Store based cursor

Field Summary

Fields

Modifier and Type	Field and Description
protected PendingList	batchList
protected boolean	batchResetNeeded
protected boolean	hadSpace
protected Destination	regionDestination
protected int	size

Fields inherited from class org.apache.activemq.broker.region.cursors.AbstractPendingMessageCursor

audit, enableAudit, last, maxAuditDepth, maxBatchSize, maxProducersToAudit, memoryUsageHighWaterMark, prioritizedMessages, systemUsage, useCache

Fields inherited from interface org.apache.activemq.broker.region.cursors.PendingMessageCursor

INFINITE_WAIT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractStoreCursor(Destination destination)

Method Summary

Modifier and Type	Method and Description
void	addMessageFirst(org.apache.activemq.broker.region.MessageReference node) add message to await dispatch
protected boolean	canEnableCash()
boolean	canRecoveryNextMessage()
void	clear() clear all pending messages
protected abstract void	doFillBatch()
protected boolean	duplicateFromStoreExcepted(org.apache.activemq.command.Message message)
protected boolean	enableCacheNow()
protected void	fillBatch()
void	finished()
void	gc() free up any internal buffers
protected abstract long	getStoreMessageSize()
protected abstract int	getStoreSize()
Subscription	getSubscription()
static boolean	gotToTheStore(org.apache.activemq.command.Message message)
boolean	hasMessagesBufferedToDeliver()
boolean	hasNext()
boolean	isCacheEnabled()
boolean	isEmpty()
protected abstract boolean	isStoreEmpty()
long	messageSize()
org.apache.activemq.broker.region.MessageReference	next()
void	rebase()
boolean	recoverMessage(org.apache.activemq.command.Message message)
boolean	recoverMessage(org.apache.activemq.command.Message message, boolean cached)
void	release() hint to the cursor to release any locks it might have grabbed after a reset
void	remove() remove the message at the cursor position
void	remove(org.apache.activemq.broker.region.MessageReference node) remove a node
void	reset() reset the cursor
protected abstract void	resetBatch()
protected void	resetSize()
protected void	setBatch(org.apache.activemq.command.MessageId messageId)
int	size()
void	start()
void	stop()
String	toString()
boolean	tryAddMessageLast(org.apache.activemq.broker.region.MessageReference node, long wait) add message to await dispatch - if it can

Methods inherited from class org.apache.activemq.broker.region.cursors.AbstractPendingMessageCursor

add, addMessageLast, addRecoveredMessage, destroy, getMaxAuditDepth, getMaxBatchSize, getMaxProducersToAudit, getMemoryUsageHighWaterMark, getMessageAudit, getSystemUsage, hasSpace, isDuplicate, isEmpty, isEnableAudit, isFull, isPrioritizedMessageSubscriber, isRecoveryRequired, isStarted, isTransient, isUseCache, pageInList, recordUniqueId, remove, resetForGC, rollback, setCacheEnabled, setEnableAudit, setMaxAuditDepth, setMaxBatchSize, setMaxProducersToAudit, setMemoryUsageHighWaterMark, setMessageAudit, setSystemUsage, setUseCache

Methods inherited from class java.lang.Object

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

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

hasSpace, isDuplicate, recoverMessageReference

Field Detail

regionDestination

protected final Destination regionDestination

batchList

protected final PendingList batchList

batchResetNeeded

protected boolean batchResetNeeded

size

protected int size

hadSpace

protected boolean hadSpace

Constructor Detail

AbstractStoreCursor

protected AbstractStoreCursor(Destination destination)

Method Detail

start

public final void start()
                 throws Exception

Specified by:

start in interface org.apache.activemq.Service

Overrides:

start in class AbstractPendingMessageCursor

Throws:

Exception

resetSize

protected void resetSize()

rebase

public void rebase()

Specified by:

rebase in interface PendingMessageCursor

Overrides:

rebase in class AbstractPendingMessageCursor

stop

public final void stop()
                throws Exception

Specified by:

stop in interface org.apache.activemq.Service

Overrides:

stop in class AbstractPendingMessageCursor

Throws:

Exception

recoverMessage

public final boolean recoverMessage(org.apache.activemq.command.Message message)
                             throws Exception

Specified by:

recoverMessage in interface MessageRecoveryListener

Throws:

Exception

recoverMessage

public boolean recoverMessage(org.apache.activemq.command.Message message,
                              boolean cached)
                       throws Exception

Throws:

Exception

duplicateFromStoreExcepted

protected boolean duplicateFromStoreExcepted(org.apache.activemq.command.Message message)

gotToTheStore

public static boolean gotToTheStore(org.apache.activemq.command.Message message)
                             throws Exception

Throws:

Exception

reset

public final void reset()

Description copied from interface: PendingMessageCursor

reset the cursor

Specified by:

reset in interface PendingMessageCursor

Overrides:

reset in class AbstractPendingMessageCursor

release

public void release()

Description copied from interface: PendingMessageCursor

hint to the cursor to release any locks it might have grabbed after a reset

Specified by:

release in interface PendingMessageCursor

Overrides:

release in class AbstractPendingMessageCursor

finished

public final void finished()

hasNext

public final boolean hasNext()

Specified by:

hasNext in interface PendingMessageCursor

Overrides:

hasNext in class AbstractPendingMessageCursor

Returns:

true if there pending messages to dispatch

next

public final org.apache.activemq.broker.region.MessageReference next()

Specified by:

next in interface PendingMessageCursor

Overrides:

next in class AbstractPendingMessageCursor

Returns:

the next pending message with its reference count increment

tryAddMessageLast

public boolean tryAddMessageLast(org.apache.activemq.broker.region.MessageReference node,
                                 long wait)
                          throws Exception

Description copied from interface: PendingMessageCursor

add message to await dispatch - if it can

Specified by:

tryAddMessageLast in interface PendingMessageCursor

Overrides:

tryAddMessageLast in class AbstractPendingMessageCursor

Returns:

true if successful

Throws:

IOException

Exception

isCacheEnabled

public boolean isCacheEnabled()

Specified by:

isCacheEnabled in interface PendingMessageCursor

Overrides:

isCacheEnabled in class AbstractPendingMessageCursor

Returns:

true if cache is being used

enableCacheNow

protected boolean enableCacheNow()

canEnableCash

protected boolean canEnableCash()

canRecoveryNextMessage

public boolean canRecoveryNextMessage()

Specified by:

canRecoveryNextMessage in interface MessageRecoveryListener

setBatch

protected void setBatch(org.apache.activemq.command.MessageId messageId)
                 throws Exception

Throws:

Exception

addMessageFirst

public void addMessageFirst(org.apache.activemq.broker.region.MessageReference node)
                     throws Exception

Description copied from interface: PendingMessageCursor

add message to await dispatch

Specified by:

addMessageFirst in interface PendingMessageCursor

Overrides:

addMessageFirst in class AbstractPendingMessageCursor

Throws:

Exception

remove

public final void remove()

Description copied from interface: PendingMessageCursor

remove the message at the cursor position

Specified by:

remove in interface PendingMessageCursor

Overrides:

remove in class AbstractPendingMessageCursor

remove

public final void remove(org.apache.activemq.broker.region.MessageReference node)

Description copied from interface: PendingMessageCursor

remove a node

Specified by:

remove in interface PendingMessageCursor

Overrides:

remove in class AbstractPendingMessageCursor

clear

public final void clear()

Description copied from interface: PendingMessageCursor

clear all pending messages

Specified by:

clear in interface PendingMessageCursor

Overrides:

clear in class AbstractPendingMessageCursor

gc

public void gc()

Description copied from interface: PendingMessageCursor

free up any internal buffers

Specified by:

gc in interface PendingMessageCursor

Overrides:

gc in class AbstractPendingMessageCursor

fillBatch

protected final void fillBatch()

Overrides:

fillBatch in class AbstractPendingMessageCursor

isEmpty

public final boolean isEmpty()

Specified by:

isEmpty in interface PendingMessageCursor

Overrides:

isEmpty in class AbstractPendingMessageCursor

Returns:

true if there are no pending messages

hasMessagesBufferedToDeliver

public final boolean hasMessagesBufferedToDeliver()

Specified by:

hasMessagesBufferedToDeliver in interface PendingMessageCursor

Overrides:

hasMessagesBufferedToDeliver in class AbstractPendingMessageCursor

Returns:

true if the cursor has buffered messages ready to deliver

size

public final int size()

Specified by:

size in interface PendingMessageCursor

Overrides:

size in class AbstractPendingMessageCursor

Returns:

the number of pending messages

messageSize

public final long messageSize()

Specified by:

messageSize in interface PendingMessageCursor

toString

public String toString()

Overrides:

toString in class Object

doFillBatch

protected abstract void doFillBatch()
                             throws Exception

Throws:

Exception

resetBatch

protected abstract void resetBatch()

getStoreSize

protected abstract int getStoreSize()

getStoreMessageSize

protected abstract long getStoreMessageSize()

isStoreEmpty

protected abstract boolean isStoreEmpty()

getSubscription

public Subscription getSubscription()