Package org.apache.druid.frame.field

Class NumericArrayFieldSelector<ElementType extends Number>

java.lang.Object

org.apache.druid.frame.field.NumericArrayFieldSelector<ElementType>

Type Parameters:

ElementType - Type of the individual array elements

All Implemented Interfaces:

HotLoopCallee, BaseDoubleColumnValueSelector, BaseFloatColumnValueSelector, BaseLongColumnValueSelector, BaseNullableColumnValueSelector, BaseObjectColumnValueSelector<Object[]>, ColumnValueSelector<Object[]>

public abstract class NumericArrayFieldSelector<ElementType extends Number>
extends Object
implements ColumnValueSelector<Object[]>

Base implementation of the column value selector that the concrete numeric field reader implementations inherit from. The selector contains the logic to construct an array written by NumericArrayFieldWriter, and present it as a column value selector. The inheritors of this class are expected to implement 1. getIndividualValueAtMemory(long) Which extracts the element from the field where it was written to. Returns null if the value at that location represents a null element 2. getIndividualFieldSize() Which informs the method about the field size corresponding to each element in the numeric array's serialized representation

Field Summary

Fields

Modifier and Type	Field	Description
protected final org.apache.datasketches.memory.Memory	memory	Memory containing the serialized values of the array

Fields inherited from interface org.apache.druid.segment.ColumnValueSelector

EMPTY_ARRAY

Constructor Summary

Constructors

Constructor	Description
NumericArrayFieldSelector(org.apache.datasketches.memory.Memory memory, ReadableFieldPointer fieldPointer)

Method Summary

Modifier and Type	Method	Description
Class<Object[]>	classOfObject()	Most-specific class of object returned by BaseObjectColumnValueSelector.getObject(), if known in advance.
double	getDouble()
float	getFloat()
abstract int	getIndividualFieldSize()	Returns the field size that each element in the reader array consumes.
abstract ElementType	getIndividualValueAtMemory(long position)	Returns the value of the individual element written at the given position
long	getLong()
Object[]	getObject()	Returns the currently-selected object.
void	inspectRuntimeShape(RuntimeShapeInspector inspector)	Implementations of this method should call inspector.visit() with all fields of this class, which meet two conditions: 1.
boolean	isNull()	Returns true if the primitive long, double, or float value returned by this selector should be treated as null.

Methods inherited from class java.lang.Object

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

Field Details

memory

protected final org.apache.datasketches.memory.Memory memory

Memory containing the serialized values of the array

Constructor Details

NumericArrayFieldSelector

public NumericArrayFieldSelector(org.apache.datasketches.memory.Memory memory,
 ReadableFieldPointer fieldPointer)

Method Details

inspectRuntimeShape

public void inspectRuntimeShape(RuntimeShapeInspector inspector)

Description copied from interface: HotLoopCallee

Implementations of this method should call inspector.visit() with all fields of this class, which meet two conditions: 1. They are used in methods of this class, annotated with CalledFromHotLoop 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 type Set could be HashSet or TreeSet 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.

Specified by:

inspectRuntimeShape in interface HotLoopCallee

getObject

@Nullable
public Object[] getObject()

Description copied from interface: BaseObjectColumnValueSelector

Returns the currently-selected object. The behavior of this method depends on the type of selector, which can be determined by calling ColumnSelectorFactory.getColumnCapabilities(String) on the same ColumnSelectorFactory that you got this selector from. If the capabilties are nonnull, the selector type is given by TypeSignature.getType(). String selectors, where type is ColumnType.STRING, may return any type of object from this method, especially in cases where the selector is casting objects to string at selection time. Callers are encouraged to avoid the need to deal with various objects by using ColumnSelectorFactory.makeDimensionSelector(org.apache.druid.query.dimension.DimensionSpec) instead. Numeric selectors, where TypeSignature.isNumeric(), may return any type of Number. Callers that wish to deal with more specific types should treat the original ColumnValueSelector as a BaseLongColumnValueSelector, BaseDoubleColumnValueSelector, or BaseFloatColumnValueSelector instead. Array selectors, where TypeSignature.isArray(), must return Object[]. The array may contain null elements, and the array itself may also be null. Selectors of unknown type, where ColumnSelectorFactory.getColumnCapabilities(String) returns null, may return any type of object. Callers must be prepared for a wide variety of possible input objects. This case is common during ingestion, where selectors are built on top of external data.

Specified by:

getObject in interface BaseObjectColumnValueSelector<ElementType extends Number>

classOfObject

public Class<Object[]> classOfObject()

Description copied from interface: BaseObjectColumnValueSelector

Most-specific class of object returned by BaseObjectColumnValueSelector.getObject(), if known in advance. This method returns Object when selectors do not know in advance what class of object they may return.

Specified by:

classOfObject in interface BaseObjectColumnValueSelector<ElementType extends Number>

getDouble

public double getDouble()

Specified by:

getDouble in interface BaseDoubleColumnValueSelector

getFloat

public float getFloat()

Specified by:

getFloat in interface BaseFloatColumnValueSelector

getLong

public long getLong()

Specified by:

getLong in interface BaseLongColumnValueSelector

isNull

public boolean isNull()

Description copied from interface: BaseNullableColumnValueSelector

Returns true if the primitive long, double, or float value returned by this selector should be treated as null. Users of BaseLongColumnValueSelector.getLong(), BaseDoubleColumnValueSelector.getDouble() and BaseFloatColumnValueSelector.getFloat() must check this method first, or else they may improperly use placeholder values returned by the primitive get methods. Users of BaseObjectColumnValueSelector.getObject() should not call this method. Instead, call "getObject" and check if it is null.

Specified by:

isNull in interface BaseNullableColumnValueSelector

getIndividualValueAtMemory

@Nullable
public abstract ElementType getIndividualValueAtMemory(long position)

Returns the value of the individual element written at the given position

getIndividualFieldSize

public abstract int getIndividualFieldSize()

Returns the field size that each element in the reader array consumes. It is usually 1 + ElementType.SIZE, to hold the element's nullity, and it's representation.