Class SimpleDoubleBufferAggregator
- java.lang.Object
-
- org.apache.druid.query.aggregation.SimpleDoubleBufferAggregator
-
- All Implemented Interfaces:
BufferAggregator
,HotLoopCallee
- Direct Known Subclasses:
DoubleMaxBufferAggregator
,DoubleMinBufferAggregator
,DoubleSumBufferAggregator
public abstract class SimpleDoubleBufferAggregator extends Object implements BufferAggregator
-
-
Constructor Summary
Constructors Constructor Description SimpleDoubleBufferAggregator(BaseDoubleColumnValueSelector selector)
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
aggregate(ByteBuffer buf, int position)
Aggregates metric values into the given aggregate byte representation Implementations of this method must read in the aggregate value from the buffer at the given position, aggregate the next element of data and write the updated aggregate value back into the buffer.abstract void
aggregate(ByteBuffer buf, int position, double value)
void
close()
Release any resources used by the aggregatorObject
get(ByteBuffer buf, int position)
Returns the intermediate object representation of the given aggregate.double
getDouble(ByteBuffer buffer, int position)
Returns the double representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value.float
getFloat(ByteBuffer buf, int position)
Returns the float representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value.long
getLong(ByteBuffer buf, int position)
Returns the long representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value.BaseDoubleColumnValueSelector
getSelector()
void
inspectRuntimeShape(RuntimeShapeInspector inspector)
Implementations of this method should callinspector.visit()
with all fields of this class, which meet two conditions: 1.abstract void
putFirst(ByteBuffer buf, int position, double value)
Faster equivalent to aggregator.init(buf, position); aggregator.aggregate(buf, position, value);-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.apache.druid.query.aggregation.BufferAggregator
init, isNull, relocate
-
-
-
-
Constructor Detail
-
SimpleDoubleBufferAggregator
public SimpleDoubleBufferAggregator(BaseDoubleColumnValueSelector selector)
-
-
Method Detail
-
getSelector
public BaseDoubleColumnValueSelector getSelector()
-
putFirst
@CalledFromHotLoop public abstract void putFirst(ByteBuffer buf, int position, double value)
Faster equivalent to aggregator.init(buf, position); aggregator.aggregate(buf, position, value);
-
aggregate
@CalledFromHotLoop public abstract void aggregate(ByteBuffer buf, int position, double value)
-
aggregate
public final void aggregate(ByteBuffer buf, int position)
Description copied from interface:BufferAggregator
Aggregates metric values into the given aggregate byte representation Implementations of this method must read in the aggregate value from the buffer at the given position, aggregate the next element of data and write the updated aggregate value back into the buffer. Implementations must not change the position, limit or mark of the given buffer- Specified by:
aggregate
in interfaceBufferAggregator
- Parameters:
buf
- byte buffer storing the byte array representation of the aggregateposition
- offset within the byte buffer at which the current aggregate value is stored
-
get
public final Object get(ByteBuffer buf, int position)
Description copied from interface:BufferAggregator
Returns the intermediate object representation of the given aggregate. Converts the given byte buffer representation into an intermediate aggregate Object Implementations must not change the position, limit or mark of the given buffer. The object returned must not have any references to the given buffer (i.e., make a copy), since the underlying buffer is a shared resource and may be given to another processing thread while the objects returned by this aggregator are still in use. If the correspondingAggregatorFactory.combine(Object, Object)
method for this aggregator expects its inputs to be mutable, then the object returned by this method must be mutable.- Specified by:
get
in interfaceBufferAggregator
- Parameters:
buf
- byte buffer storing the byte array representation of the aggregateposition
- offset within the byte buffer at which the aggregate value is stored- Returns:
- the Object representation of the aggregate
-
getFloat
public final float getFloat(ByteBuffer buf, int position)
Description copied from interface:BufferAggregator
Returns the float representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value. Implementations must not change the position, limit or mark of the given buffer Implementations are only required to support this method if they are aggregations which have anAggregatorFactory.getIntermediateType()
()} ofValueType.FLOAT
. If unimplemented, throwing anUnsupportedOperationException
is common and recommended.- Specified by:
getFloat
in interfaceBufferAggregator
- Parameters:
buf
- byte buffer storing the byte array representation of the aggregateposition
- offset within the byte buffer at which the aggregate value is stored- Returns:
- the float representation of the aggregate
-
getLong
public final long getLong(ByteBuffer buf, int position)
Description copied from interface:BufferAggregator
Returns the long representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value. Implementations must not change the position, limit or mark of the given buffer Implementations are only required to support this method if they are aggregations which have anAggregatorFactory.getIntermediateType()
of ofValueType.LONG
. If unimplemented, throwing anUnsupportedOperationException
is common and recommended.- Specified by:
getLong
in interfaceBufferAggregator
- Parameters:
buf
- byte buffer storing the byte array representation of the aggregateposition
- offset within the byte buffer at which the aggregate value is stored- Returns:
- the long representation of the aggregate
-
getDouble
public double getDouble(ByteBuffer buffer, int position)
Description copied from interface:BufferAggregator
Returns the double representation of the given aggregate byte array Converts the given byte buffer representation into the intermediate aggregate value. Implementations must not change the position, limit or mark of the given buffer Implementations are only required to support this method if they are aggregations which have anAggregatorFactory.getIntermediateType()
of ofValueType.DOUBLE
. If unimplemented, throwing anUnsupportedOperationException
is common and recommended. The default implementation castsBufferAggregator.getFloat(ByteBuffer, int)
to double. This default method is added to enable smooth backward compatibility, please re-implement it if your aggregators work with numeric double columns.- Specified by:
getDouble
in interfaceBufferAggregator
- Parameters:
buffer
- byte buffer storing the byte array representation of the aggregateposition
- offset within the byte buffer at which the aggregate value is stored- Returns:
- the double representation of the aggregate
-
close
public void close()
Description copied from interface:BufferAggregator
Release any resources used by the aggregator- Specified by:
close
in interfaceBufferAggregator
-
inspectRuntimeShape
public void inspectRuntimeShape(RuntimeShapeInspector inspector)
Description copied from interface:BufferAggregator
Implementations of this method should callinspector.visit()
with all fields of this class, which meet two conditions: 1. They are used in methods of this class, annotated withCalledFromHotLoop
2. They are either: a. Nullable objects b. Instances of HotLoopCallee c. Objects, which don't always have a specific class in runtime. For example, a field of typeSet
could beHashSet
orTreeSet
in runtime, depending on how this instance (the instance on which inspectRuntimeShape() is called) is configured. d. ByteBuffer or similar objects, where byte order matters e. boolean flags, affecting branch taking f. Arrays of objects, meeting any of conditions a-e.The default implementation inspects nothing. Classes that implement
BufferAggregator
are encouraged to override this method, following the specification ofHotLoopCallee.inspectRuntimeShape(org.apache.druid.query.monomorphicprocessing.RuntimeShapeInspector)
.- Specified by:
inspectRuntimeShape
in interfaceBufferAggregator
- Specified by:
inspectRuntimeShape
in interfaceHotLoopCallee
-
-