com.phloc.commons.concurrent.collector

Class AbstractConcurrentCollector<DATATYPE>

java.lang.Object

com.phloc.commons.concurrent.collector.AbstractConcurrentCollector<DATATYPE>

Type Parameters:

DATATYPE - The type of the objects in the queue.

All Implemented Interfaces:

INonThrowingRunnable, IThrowingRunnable, IConcurrentCollector<DATATYPE>, Runnable

Direct Known Subclasses:

ConcurrentCollectorMultiple, ConcurrentCollectorSingle

public abstract class AbstractConcurrentCollector<DATATYPE>
extends Object
implements INonThrowingRunnable, IConcurrentCollector<DATATYPE>

Abstract concurrent collector.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_QUEUE_SIZE Default maximum queue size
protected BlockingQueue<Object>	m_aQueue
protected static Object	STOP_QUEUE_OBJECT

Constructor Summary

Constructors

Constructor and Description
AbstractConcurrentCollector(int nMaxQueueSize) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
int	getQueueLength()
boolean	isStopped() Check if this collector is already stopped.
ESuccess	queueObject(DATATYPE aObject) Submit an object to the queue.
ESuccess	stopQueuingNewObjects() Stop taking new objects in the collector.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.phloc.commons.callback.INonThrowingRunnable

run

Field Detail

DEFAULT_MAX_QUEUE_SIZE

public static final int DEFAULT_MAX_QUEUE_SIZE

Default maximum queue size

See Also:

Constant Field Values

STOP_QUEUE_OBJECT

protected static final Object STOP_QUEUE_OBJECT

m_aQueue

protected final BlockingQueue<Object> m_aQueue

Constructor Detail

AbstractConcurrentCollector

public AbstractConcurrentCollector(@Nonnegative
                           int nMaxQueueSize)

Constructor.

Parameters:

nMaxQueueSize - The maximum number of items that can be in the queue. Must be > 0.

Method Detail

queueObject

@Nonnull
public final ESuccess queueObject(@Nonnull
                           DATATYPE aObject)

Description copied from interface: IConcurrentCollector

Submit an object to the queue.

Specified by:

queueObject in interface IConcurrentCollector<DATATYPE>

Parameters:

aObject - The object to submit. May not be null.

Returns:

ESuccess

getQueueLength

@Nonnegative
public final int getQueueLength()

Specified by:

getQueueLength in interface IConcurrentCollector<DATATYPE>

Returns:

The number of objects currently in the queue.

stopQueuingNewObjects

@Nonnull
public final ESuccess stopQueuingNewObjects()

Description copied from interface: IConcurrentCollector

Stop taking new objects in the collector. Returns directly and does not wait until the processing finished.

Specified by:

stopQueuingNewObjects in interface IConcurrentCollector<DATATYPE>

Returns:

ESuccess

isStopped

public final boolean isStopped()

Description copied from interface: IConcurrentCollector

Check if this collector is already stopped.

Specified by:

isStopped in interface IConcurrentCollector<DATATYPE>

Returns:

true if the collector is stopped, false otherwise.