org.apache.activemq.broker.region.cursors
Class StoreQueueCursor

java.lang.Object
  org.apache.activemq.broker.region.cursors.AbstractPendingMessageCursor
      org.apache.activemq.broker.region.cursors.StoreQueueCursor

All Implemented Interfaces:

PendingMessageCursor, Service

public class StoreQueueCursor
extends AbstractPendingMessageCursor

Store based Cursor for Queues

Field Summary

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

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

Constructor Summary

StoreQueueCursor(Broker broker, Queue queue)
Construct

Method Summary

void	addMessageFirst(MessageReference node) add message to await dispatch
void	addMessageLast(MessageReference node) add message to await dispatch
void	clear() clear all pending messages
void	gc() free up any internal buffers
protected PendingMessageCursor	getNextCursor()
PendingMessageCursor	getNonPersistent()
boolean	hasNext()
boolean	isCacheEnabled()
boolean	isEmpty()
boolean	isRecoveryRequired() Informs the Broker if the subscription needs to intervention to recover it's state e.g.
MessageReference	next()
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(MessageReference node) remove a node
void	reset() reset the cursor
void	setEnableAudit(boolean enableAudit)
void	setMaxAuditDepth(int maxAuditDepth) Set the maximum depth of message ids to track
void	setMaxBatchSize(int maxBatchSize) Set the max batch size
void	setMaxProducersToAudit(int maxProducersToAudit) set the maximum number of producers to track at one time
void	setMemoryUsageHighWaterMark(int memoryUsageHighWaterMark)
void	setNonPersistent(PendingMessageCursor nonPersistent)
void	setSystemUsage(SystemUsage usageManager) Set the UsageManager
void	setUseCache(boolean useCache) use a cache to improve performance
int	size()
void	start()
void	stop()

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

add, addRecoveredMessage, destroy, fillBatch, getMaxAuditDepth, getMaxBatchSize, getMaxProducersToAudit, getMemoryUsageHighWaterMark, getMessageAudit, getSystemUsage, hasMessagesBufferedToDeliver, hasSpace, isDuplicate, isEmpty, isEnableAudit, isFull, isPrioritizedMessageSubscriber, isStarted, isTransient, isUseCache, pageInList, recordUniqueId, remove, resetForGC, rollback, setCacheEnabled, setMessageAudit, tryAddMessageLast

Methods inherited from class java.lang.Object

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

Constructor Detail

StoreQueueCursor

public StoreQueueCursor(Broker broker,
                        Queue queue)

Construct

Parameters:

broker -

queue -

Method Detail

start

public void start()
           throws Exception

Specified by:

start in interface Service

Overrides:

start in class AbstractPendingMessageCursor

Throws:

Exception

stop

public void stop()
          throws Exception

Specified by:

stop in interface Service

Overrides:

stop in class AbstractPendingMessageCursor

Throws:

Exception

addMessageLast

public void addMessageLast(MessageReference node)
                    throws Exception

Description copied from interface: PendingMessageCursor

add message to await dispatch

Specified by:

addMessageLast in interface PendingMessageCursor

Overrides:

addMessageLast in class AbstractPendingMessageCursor

Throws:

IOException

Exception

addMessageFirst

public void addMessageFirst(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

clear

public void clear()

Description copied from interface: PendingMessageCursor

clear all pending messages

Specified by:

clear in interface PendingMessageCursor

Overrides:

clear in class AbstractPendingMessageCursor

hasNext

public boolean hasNext()

Specified by:

hasNext in interface PendingMessageCursor

Overrides:

hasNext in class AbstractPendingMessageCursor

Returns:

true if there pending messages to dispatch

next

public MessageReference next()

Specified by:

next in interface PendingMessageCursor

Overrides:

next in class AbstractPendingMessageCursor

Returns:

the next pending message with its reference count increment

remove

public 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 void remove(MessageReference node)

Description copied from interface: PendingMessageCursor

remove a node

Specified by:

remove in interface PendingMessageCursor

Overrides:

remove in class AbstractPendingMessageCursor

reset

public 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

size

public int size()

Specified by:

size in interface PendingMessageCursor

Overrides:

size in class AbstractPendingMessageCursor

Returns:

the number of pending messages

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface PendingMessageCursor

Overrides:

isEmpty in class AbstractPendingMessageCursor

Returns:

true if there are no pending messages

isRecoveryRequired

public boolean isRecoveryRequired()

Informs the Broker if the subscription needs to intervention to recover it's state e.g. DurableTopicSubscriber may do

Specified by:

isRecoveryRequired in interface PendingMessageCursor

Overrides:

isRecoveryRequired in class AbstractPendingMessageCursor

Returns:

true if recovery required

See Also:

PendingMessageCursor

getNonPersistent

public PendingMessageCursor getNonPersistent()

Returns:

the nonPersistent Cursor

setNonPersistent

public void setNonPersistent(PendingMessageCursor nonPersistent)

Parameters:

nonPersistent - cursor to set

setMaxBatchSize

public void setMaxBatchSize(int maxBatchSize)

Description copied from interface: PendingMessageCursor

Set the max batch size

Specified by:

setMaxBatchSize in interface PendingMessageCursor

Overrides:

setMaxBatchSize in class AbstractPendingMessageCursor

setMaxProducersToAudit

public void setMaxProducersToAudit(int maxProducersToAudit)

Description copied from interface: PendingMessageCursor

set the maximum number of producers to track at one time

Specified by:

setMaxProducersToAudit in interface PendingMessageCursor

Overrides:

setMaxProducersToAudit in class AbstractPendingMessageCursor

Parameters:

maxProducersToAudit - the maxProducersToAudit to set

setMaxAuditDepth

public void setMaxAuditDepth(int maxAuditDepth)

Description copied from interface: PendingMessageCursor

Set the maximum depth of message ids to track

Specified by:

setMaxAuditDepth in interface PendingMessageCursor

Overrides:

setMaxAuditDepth in class AbstractPendingMessageCursor

Parameters:

maxAuditDepth - the maxAuditDepth to set

setEnableAudit

public void setEnableAudit(boolean enableAudit)

Specified by:

setEnableAudit in interface PendingMessageCursor

Overrides:

setEnableAudit in class AbstractPendingMessageCursor

Parameters:

enableAudit - the enableAudit to set

setUseCache

public void setUseCache(boolean useCache)

Description copied from interface: PendingMessageCursor

use a cache to improve performance

Specified by:

setUseCache in interface PendingMessageCursor

Overrides:

setUseCache in class AbstractPendingMessageCursor

setMemoryUsageHighWaterMark

public void setMemoryUsageHighWaterMark(int memoryUsageHighWaterMark)

Specified by:

setMemoryUsageHighWaterMark in interface PendingMessageCursor

Overrides:

setMemoryUsageHighWaterMark in class AbstractPendingMessageCursor

Parameters:

memoryUsageHighWaterMark - the memoryUsageHighWaterMark to set

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

setSystemUsage

public void setSystemUsage(SystemUsage usageManager)

Description copied from interface: PendingMessageCursor

Set the UsageManager

Specified by:

setSystemUsage in interface PendingMessageCursor

Overrides:

setSystemUsage in class AbstractPendingMessageCursor

See Also:

SystemUsage

getNextCursor

protected PendingMessageCursor getNextCursor()
                                      throws Exception

Throws:

Exception

isCacheEnabled

public boolean isCacheEnabled()

Specified by:

isCacheEnabled in interface PendingMessageCursor

Overrides:

isCacheEnabled in class AbstractPendingMessageCursor

Returns:

true if cache is being used