Package 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, org.apache.activemq.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, cacheEnabled, enableAudit, last, maxAuditDepth, maxBatchSize, maxProducersToAudit, memoryUsageHighWaterMark, prioritizedMessages, started, systemUsage, useCache

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

INFINITE_WAIT

Constructor Summary

Constructors

Constructor	Description
StoreQueueCursor(Broker broker, Queue queue)	Construct

Method Summary

Modifier and Type	Method	Description
void	addMessageFirst(org.apache.activemq.broker.region.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()
PendingMessageCursor	getPersistent()
boolean	hasNext()
boolean	isCacheEnabled()
boolean	isEmpty()
boolean	isRecoveryRequired()	Informs the Broker if the subscription needs to intervention to recover it's state e.g.
long	messageSize()
org.apache.activemq.broker.region.MessageReference	next()
void	rebase()
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
void	rollback(org.apache.activemq.command.MessageId id)	remove from auditing the message id
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()
boolean	tryAddMessageLast(org.apache.activemq.broker.region.MessageReference node, long maxWait)	add message to await dispatch - if it can

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

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

Methods inherited from class java.lang.Object

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

Constructor Details

StoreQueueCursor

public StoreQueueCursor(Broker broker,
 Queue queue)

Construct

Parameters:

broker -

queue -

Method Details

start

public void start()
           throws Exception

Specified by:

start in interface org.apache.activemq.Service

Overrides:

start in class AbstractPendingMessageCursor

Throws:

Exception

stop

public void stop()
          throws Exception

Specified by:

stop in interface org.apache.activemq.Service

Overrides:

stop in class AbstractPendingMessageCursor

Throws:

Exception

tryAddMessageLast

public boolean tryAddMessageLast(org.apache.activemq.broker.region.MessageReference node,
 long maxWait)
                          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

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

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 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

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(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

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

messageSize

public long messageSize()

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

getPersistent

public PendingMessageCursor getPersistent()

Returns:

the persistent Cursor

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

rollback

public void rollback(org.apache.activemq.command.MessageId id)

Description copied from interface: PendingMessageCursor

remove from auditing the message id

Specified by:

rollback in interface PendingMessageCursor

Overrides:

rollback in class AbstractPendingMessageCursor

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

rebase

public void rebase()

Specified by:

rebase in interface PendingMessageCursor

Overrides:

rebase in class AbstractPendingMessageCursor