Class CompositeAggregator<K,V>

java.lang.Object

com.tangosol.util.Base

com.tangosol.util.BitHelper

com.tangosol.util.ExternalizableHelper

com.tangosol.util.aggregator.CompositeAggregator<K,V>

All Implemented Interfaces:

ExternalizableLite, PortableObject, InvocableMap.EntryAggregator<K,V,List>, InvocableMap.StreamingAggregator<K,V,Object,List>, Serializable

Direct Known Subclasses:

CompositeAggregator.Parallel

public class CompositeAggregator<K,V>
extends ExternalizableHelper
implements InvocableMap.StreamingAggregator<K,V,Object,List>, ExternalizableLite, PortableObject

CompositeAggregator provides an ability to execute a collection of aggregators against the same subset of the entries in an InvocableMap, resulting in a list of corresponding aggregation results. The size of the returned list will always be equal to the length of the aggregators' array.

Since:

Coherence 3.2

Author:

gg 2006.02.08

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CompositeAggregator.Parallel	Deprecated. As of Coherence 12.2.1.

Nested classes/interfaces inherited from class ExternalizableHelper

ExternalizableHelper.DecoratedMultiBufferReadBuffer, ExternalizableHelper.DecorationAware, ExternalizableHelper.DefaultObjectStreamFactory, ExternalizableHelper.FormatAwareCompressor, ExternalizableHelper.IntDecoratedObject, ExternalizableHelper.Shielded, ExternalizableHelper.ShieldedDataOutputStream, ExternalizableHelper.ShieldedInputStream, ExternalizableHelper.ShieldedObjectOutputStream, ExternalizableHelper.ShieldedOutputStream, ExternalizableHelper.SimpleXmlBeanClassCache, ExternalizableHelper.Stats, ExternalizableHelper.XmlBeanClassCache

Nested classes/interfaces inherited from class Base

Base.LoggingWriter

Nested classes/interfaces inherited from interface InvocableMap.StreamingAggregator

InvocableMap.StreamingAggregator.RetractionResult

Field Summary

Fields

Modifier and Type	Field	Description
protected InvocableMap.EntryAggregator[]	m_aAggregator	The underlying EntryAggregator array.
protected List[]	m_aParallelResults	An array of partial results for each aggregator.
protected boolean	m_fContinuous	Flag specifying whether all delegates support continuous maintenance.
protected boolean	m_fInit	Flag specifying whether this aggregator has been initialized.
protected boolean	m_fParallel	Flag specifying whether parallel optimizations can be used.
protected boolean	m_fStateCheckpointable	Flag specifying whether all delegates support state checkpoints.
protected boolean	m_fStreaming	Flag specifying whether streaming optimizations can be used.
protected Set	m_setEntries	A set of accumulated entries to aggregate.

Fields inherited from class ExternalizableHelper

BINARY_SIZE, CHUNK_SIZE, CHUNK_THRESHOLD, CONVERTER_FROM_BINARY, CONVERTER_STRIP_INTDECO, CONVERTER_TO_BINARY, DECO_APP_1, DECO_APP_2, DECO_APP_3, DECO_BACKUP, DECO_CUSTOM, DECO_EXPIRY, DECO_ID_MAX, DECO_ID_MIN, DECO_JCACHE, DECO_JCACHE_SYNTHETIC, DECO_MEMCACHED, DECO_PUSHREP, DECO_RSVD_1, DECO_STORE, DECO_TOPLINK, DECO_TX, DECO_VALUE, DECO_VECTOR, DECO_WLS, EMPTY_BINARY_ARRAY, FMT_B_ARRAY, FMT_BIN_DECO, FMT_BIN_EXT_DECO, FMT_BINARY, FMT_BOOLEAN, FMT_BYTE, FMT_DECIMAL, FMT_DOUBLE, FMT_EXT, FMT_FLOAT, FMT_IDO, FMT_INT, FMT_INTEGER, FMT_LONG, FMT_NONE, FMT_NULL, FMT_OBJ_EXT, FMT_OBJ_SER, FMT_OPT, FMT_OPT_DOUBLE, FMT_OPT_INT, FMT_OPT_LONG, FMT_SHORT, FMT_STRING, FMT_UNKNOWN, FMT_XML_BEAN, FMT_XML_SER, FORCE_RESOLVING_STREAMS, LAMBDA_SERIALIZATION, MAX_DECO_HEADER_BYTES, MAX_MEMCACHED_PASS_THROUGH_FORMAT_DEPTH, PACKED_INT_SIZE, PACKED_LONG_SIZE, PROPERTY_CONFIG, s_streamfactory, s_tloInEHDeserialize, TRINT_DOMAIN_SPAN, TRINT_MAX_VALUE, TRINT_MAX_VARIANCE, USE_POF_STREAMS, USE_XMLBEAN_CLASS_CACHE, XMLBEAN_CLASS_CACHE

Fields inherited from class Base

DEFAULT_LOAD_FACTOR, LOG_ALWAYS, LOG_CONFIG, LOG_DEBUG, LOG_ERR, LOG_INFO, LOG_MAX, LOG_MIN, LOG_QUIET, LOG_WARN, POWER_0, POWER_G, POWER_K, POWER_M, POWER_T, UNIT_D, UNIT_H, UNIT_M, UNIT_MS, UNIT_NS, UNIT_S, UNIT_US

Fields inherited from interface InvocableMap.StreamingAggregator

ALLOW_INCONSISTENCIES, BY_MEMBER, BY_PARTITION, CONTINUOUS, PARALLEL, PRESENT_ONLY, RETAINS_ENTRIES, SERIAL, STATE_CHECKPOINTABLE

Constructor Summary

Constructors

Constructor	Description
CompositeAggregator()	Default constructor (necessary for the ExternalizableLite interface).
CompositeAggregator(InvocableMap.EntryAggregator[] aAggregator)	Construct a CompositeAggregator based on a specified EntryAggregator array.

Method Summary

Modifier and Type	Method	Description
boolean	accumulate(InvocableMap.Entry entry)	Accumulate one entry into the result.
List	aggregate(Set setEntries)	Process a set of InvocableMap Entry objects using each of the underlying agregators in order to produce an array of aggregated results.
int	characteristics()	A bit mask representing the set of characteristics of this aggregator.
boolean	combine(Object oResultPart)	Merge another partial result into the result.
static CompositeAggregator	createInstance(InvocableMap.EntryAggregator[] aAggregator)	Create an instance of CompositeAggregator based on a specified EntryAggregator array.
protected void	ensureInitialized()	Ensure that this aggregator is initialized.
boolean	equals(Object o)	Compare the CompositeAggregator with another object to determine equality.
List	finalizeResult()	Return the final result of the aggregation.
InvocableMap.EntryAggregator[]	getAggregators()	Obtain the EntryAggregator array.
InvocableMap.StreamingAggregator.RetractionResult	getMaintenanceStatus()	Return the current maintenance status of this aggregator.
Object	getPartialResult()	Return the partial result of the aggregation.
int	hashCode()	Determine a hash value for the MultiExtractor object according to the general Object.hashCode() contract.
void	readExternal(PofReader in)	Restore the contents of a user type instance by reading its state using the specified PofReader object.
void	readExternal(DataInput in)	Restore the contents of this object by loading the object's state from the passed DataInput object.
void	restoreState(Object oState)	Restore a maintenance-state snapshot into this empty supplied instance.
InvocableMap.StreamingAggregator.RetractionResult	retract(InvocableMap.Entry entry)	Retract the contribution of a single entry from the aggregation result.
Object	snapshotState()	Return a detached, serializer-compatible snapshot of the state required to continue incremental maintenance.
InvocableMap.StreamingAggregator<K,V,Object,List>	supply()	Create a new instance of this aggregator.
String	toString()	Return a human-readable description for this ValueExtractor.
InvocableMap.StreamingAggregator.RetractionResult	update(InvocableMap.Entry entry)	Replace the contribution of an entry that was present before and remains present after a map update.
void	writeExternal(PofWriter out)	Save the contents of a POF user type instance by writing its state using the specified PofWriter object.
void	writeExternal(DataOutput out)	Save the contents of this object by storing the object's state into the passed DataOutput object.

Methods inherited from class ExternalizableHelper

asBinary, calculatePackedLength, calculatePackedLength, checkObjectInputFilter, checkObjectInputFilter, checkObjectInputFilter, convertUTF, decodeExpiry, decorate, decorate, decorate, decorate, decorate, decorateBinary, encodeExpiry, ensureSerializer, extractIntDecoration, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromByteArray, fromByteArray, getClass, getConfigSerialFilter, getConfigSerialFilterFactory, getDecoration, getDecoration, getDecorations, getDeltaCompressor, getInputStream, getNewObjectInput, getObjectInput, getObjectInputFilter, getObjectOutput, getObjectStreamFactory, getOutputStream, getShieldedOutputStream, getStreamFormat, getUndecorated, getUndecorated, isDecorated, isDecorated, isIntDecorated, isIntDecorated, isPatchCompatible, isPatchCompatible, isResolving, isSerializable, isSerializerCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, isVersionCompatible, loadClass, loadResource, main, makeTrint, newFilteredObjectInputStream, newFilteredObjectInputStream, readBigDecimal, readBigInteger, readBooleanArray, readBooleanArray, readByteArray, readCharArray, readCharArray, readCollection, readDate, readDoubleArray, readDoubleArray, readExternalizableLite, readExternalizableLite, readFloatArray, readFloatArray, readInt, readInt, readIntArray, readIntArray, readIntArray2d, readLargeBooleanArray, readLargeByteArray, readLargeCharArray, readLargeDoubleArray, readLargeFloatArray, readLargeIntArray, readLargeLongArray, readLargeObjectArray, readLargeStringArray, readLong, readLong, readLongArray, readLongArray, readMap, readMap, readObject, readObject, readObjectArray, readObjectArray, readSafeUTF, readSafeUTF, readSerializable, readSerializable, readStringArray, readStringArray, readTime, readTimestamp, readTrint, readUnsignedTrint, readUTF, readXmlBean, readXmlSerializable, readXmlSerializable, realize, removeIntDecoration, removeIntDecoration, replace, reportIncompatibleSerializers, reportIncompatibleSerializers, reportIncompatibleSerializers, reportIncompatibleSerializers, setObjectStreamFactory, toBinary, toBinary, toBinary, toByteArray, toByteArray, toByteArray, toLiteBinary, toLong, undecorate, undecorate, validateBufferSize, validateLoadArray, validateLoadClass, validateMemcachedPassThroughValue, validateMemcachedPassThroughValue, validateMemcachedPassThroughValue, validateMemcachedPassThroughValue, writeBigDecimal, writeBigInteger, writeBooleanArray, writeByteArray, writeCollection, writeDate, writeDoubleArray, writeExternalizableLite, writeFloatArray, writeInt, writeInt, writeIntArray, writeIntArray2d, writeLong, writeLong, writeLongArray, writeMap, writeObject, writeSafeUTF, writeSafeUTF, writeSerializable, writeStringArray, writeTime, writeTimestamp, writeTrint, writeTrint, writeUTF, writeXmlBean, writeXmlSerializable

Methods inherited from class BitHelper

countBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, rotateLeft, rotateLeft, rotateLeft, rotateRight, rotateRight, rotateRight, toBitString, toBitString, toBitString, toBytes, toBytes, toBytes, toBytes, toInt, toInt, toLong

Methods inherited from class Base

azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getProcessRandom, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mergeArray, mergeBooleanArray, mergeByteArray, mergeCharArray, mergeDoubleArray, mergeFloatArray, mergeIntArray, mergeLongArray, mod, mod, newHashMap, newHashMap, newHashSet, newHashSet, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface InvocableMap.StreamingAggregator

accumulate, finalizeResult, isAllowInconsistencies, isByMember, isByPartition, isContinuous, isParallel, isPresentOnly, isRetainsEntries, isSerial, isStateCheckpointable

Field Details

m_aAggregator

protected InvocableMap.EntryAggregator[] m_aAggregator

The underlying EntryAggregator array.

m_fInit

protected transient boolean m_fInit

Flag specifying whether this aggregator has been initialized.

m_fStreaming

protected transient boolean m_fStreaming

Flag specifying whether streaming optimizations can be used.

m_fContinuous

protected transient boolean m_fContinuous

Flag specifying whether all delegates support continuous maintenance.

m_fStateCheckpointable

protected transient boolean m_fStateCheckpointable

Flag specifying whether all delegates support state checkpoints.

m_fParallel

protected transient boolean m_fParallel

Flag specifying whether parallel optimizations can be used.

m_setEntries

protected transient Set m_setEntries

A set of accumulated entries to aggregate.

m_aParallelResults

protected transient List[] m_aParallelResults

An array of partial results for each aggregator.

Constructor Details

CompositeAggregator

public CompositeAggregator()

Default constructor (necessary for the ExternalizableLite interface).

CompositeAggregator

public CompositeAggregator(InvocableMap.EntryAggregator[] aAggregator)

Construct a CompositeAggregator based on a specified EntryAggregator array.

Parameters:

aAggregator - an array of EntryAggregator objects; may not be null

Method Details

aggregate

public List aggregate(Set setEntries)

Process a set of InvocableMap Entry objects using each of the underlying agregators in order to produce an array of aggregated results.

Specified by:

aggregate in interface InvocableMap.EntryAggregator<K,V,List>

Specified by:

aggregate in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

setEntries - a Set of read-only InvocableMap Entry objects to aggregate

Returns:

a List of aggregated results from processing the entries by the corresponding underlying aggregators

supply

public InvocableMap.StreamingAggregator<K,V,Object,List> supply()

Description copied from interface: InvocableMap.StreamingAggregator

Create a new instance of this aggregator.

Specified by:

supply in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

a StreamAggregator

accumulate

public boolean accumulate(InvocableMap.Entry entry)

Description copied from interface: InvocableMap.StreamingAggregator

Accumulate one entry into the result.

Specified by:

accumulate in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

entry - the entry to accumulate into the aggregation result

Returns:

true to continue the aggregation, and false to signal to the caller that the result is ready and the aggregation can be short-circuited

retract

public InvocableMap.StreamingAggregator.RetractionResult retract(InvocableMap.Entry entry)

Description copied from interface: InvocableMap.StreamingAggregator

Retract the contribution of a single entry from the aggregation result.

When the supplied entry is a MapTrigger.Entry, an implementation should retract the entry's original value. Otherwise, it should retract the value represented by the supplied entry.

The default implementation cannot retract an entry and requires the caller to rebuild the aggregation result.

Specified by:

retract in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

entry - the entry to retract

Returns:

the state of the aggregation result after the retraction

update

public InvocableMap.StreamingAggregator.RetractionResult update(InvocableMap.Entry entry)

Description copied from interface: InvocableMap.StreamingAggregator

Replace the contribution of an entry that was present before and remains present after a map update.

The supplied entry is expected to be a MapTrigger.Entry exposing both its original and current values. The default implementation retracts the original contribution, accumulates the current contribution, and therefore preserves the semantics of an update for aggregators that do not provide a specialized implementation.

Specified by:

update in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

entry - the updated entry

Returns:

the state of the aggregation result after the update

getMaintenanceStatus

public InvocableMap.StreamingAggregator.RetractionResult getMaintenanceStatus()

Description copied from interface: InvocableMap.StreamingAggregator

Return the current maintenance status of this aggregator.

This method is evaluated after an update has been fully applied, so an aggregator may report InvocableMap.StreamingAggregator.RetractionResult.STALE_BOUND from InvocableMap.StreamingAggregator.retract(Entry) and return InvocableMap.StreamingAggregator.RetractionResult.UPDATED here if accumulating the replacement value restored an exact result.

Specified by:

getMaintenanceStatus in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

the current maintenance status

combine

public boolean combine(Object oResultPart)

Description copied from interface: InvocableMap.StreamingAggregator

Merge another partial result into the result.

Specified by:

combine in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

oResultPart - the partial result to merge

Returns:

true to continue the aggregation, and false to signal to the caller that the result is ready and the aggregation can be short-circuited

getPartialResult

public Object getPartialResult()

Description copied from interface: InvocableMap.StreamingAggregator

Return the partial result of the aggregation.

Specified by:

getPartialResult in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

the partial result of the aggregation

finalizeResult

public List finalizeResult()

Description copied from interface: InvocableMap.StreamingAggregator

Return the final result of the aggregation.

Specified by:

finalizeResult in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

the final result of the aggregation

characteristics

public int characteristics()

Description copied from interface: InvocableMap.StreamingAggregator

A bit mask representing the set of characteristics of this aggregator.

By default, characteristics are a combination of InvocableMap.StreamingAggregator.PARALLEL and InvocableMap.StreamingAggregator.RETAINS_ENTRIES, which is sub-optimal and should be overridden by the aggregator implementation if the aggregator does not need to retain entries (which is often the case).

Specified by:

characteristics in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

a bit mask representing the set of characteristics of this aggregator

See Also:

• InvocableMap.StreamingAggregator.ALLOW_INCONSISTENCIES
• InvocableMap.StreamingAggregator.BY_MEMBER
• InvocableMap.StreamingAggregator.BY_PARTITION
• InvocableMap.StreamingAggregator.CONTINUOUS
• InvocableMap.StreamingAggregator.STATE_CHECKPOINTABLE
• InvocableMap.StreamingAggregator.PARALLEL
• InvocableMap.StreamingAggregator.PRESENT_ONLY
• InvocableMap.StreamingAggregator.RETAINS_ENTRIES
• InvocableMap.StreamingAggregator.SERIAL

snapshotState

public Object snapshotState()

Description copied from interface: InvocableMap.StreamingAggregator

Return a detached, serializer-compatible snapshot of the state required to continue incremental maintenance.

This method is used only when InvocableMap.StreamingAggregator.STATE_CHECKPOINTABLE is advertised. The default implementation does not support state checkpointing.

Specified by:

snapshotState in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Returns:

a detached maintenance-state snapshot

restoreState

public void restoreState(Object oState)

Description copied from interface: InvocableMap.StreamingAggregator

Restore a maintenance-state snapshot into this empty supplied instance.

This method is used only when InvocableMap.StreamingAggregator.STATE_CHECKPOINTABLE is advertised. The default implementation does not support state checkpointing.

Specified by:

restoreState in interface InvocableMap.StreamingAggregator<K,V,Object,List>

Parameters:

oState - the snapshot returned by InvocableMap.StreamingAggregator.snapshotState()

ensureInitialized

protected void ensureInitialized()

Ensure that this aggregator is initialized.

readExternal

public void readExternal(DataInput in)
                  throws IOException

Restore the contents of this object by loading the object's state from the passed DataInput object.

Specified by:

readExternal in interface ExternalizableLite

Parameters:

in - the DataInput stream to read data from in order to restore the state of this object

Throws:

IOException - if an I/O exception occurs

writeExternal

public void writeExternal(DataOutput out)
                   throws IOException

Save the contents of this object by storing the object's state into the passed DataOutput object.

Specified by:

writeExternal in interface ExternalizableLite

Parameters:

out - the DataOutput stream to write the state of this object to

Throws:

IOException - if an I/O exception occurs

readExternal

public void readExternal(PofReader in)
                  throws IOException

Restore the contents of a user type instance by reading its state using the specified PofReader object.

Specified by:

readExternal in interface PortableObject

Parameters:

in - the PofReader from which to read the object's state

Throws:

IOException - if an I/O error occurs

writeExternal

public void writeExternal(PofWriter out)
                   throws IOException

Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Specified by:

writeExternal in interface PortableObject

Parameters:

out - the PofWriter to which to write the object's state

Throws:

IOException - if an I/O error occurs

getAggregators

public InvocableMap.EntryAggregator[] getAggregators()

Obtain the EntryAggregator array.

Returns:

the EntryAggregator array

equals

public boolean equals(Object o)

Compare the CompositeAggregator with another object to determine equality.

Overrides:

equals in class Object

Returns:

true iff this CompositeAggregator and the passed object are equivalent

hashCode

public int hashCode()

Determine a hash value for the MultiExtractor object according to the general Object.hashCode() contract.

Overrides:

hashCode in class Object

Returns:

an integer hash value for this ValueExtractor object

toString

public String toString()

Return a human-readable description for this ValueExtractor.

Overrides:

toString in class Object

Returns:

a String description of the ValueExtractor

createInstance

public static CompositeAggregator createInstance(InvocableMap.EntryAggregator[] aAggregator)

Create an instance of CompositeAggregator based on a specified EntryAggregator array. If all the aggregators in the specified array are instances of ParallelAwareAggregator, then a parallel-aware instance of the CompositeAggregator will be created.
If at least one of the specified aggregator is not parallel-aware, then the resulting CompositeAggregator will not be parallel-aware and could be ill-suited for aggregations run against large partitioned caches.

Parameters:

aAggregator - an array of EntryAggregator objects; must contain not less than two aggregators