Package io.deephaven.engine.table.impl
Class AbstractColumnSource<T>
java.lang.Object
io.deephaven.engine.table.impl.AbstractColumnSource<T>
- All Implemented Interfaces:
ChunkSource<Values>
,ChunkSource.WithPrev<Values>
,ColumnSource<T>
,ElementSource<T>
,FillContextMaker
,GetContextMaker
,DefaultChunkSource<Values>
,DefaultChunkSource.WithPrev<Values>
,Releasable
,TupleExporter<T>
,TupleSource<T>
- Direct Known Subclasses:
AbstractArrowColumnSource
,AbstractColumnSource.DefaultedImmutable
,AbstractColumnSource.DefaultedMutable
,AlternatingColumnSource
,ArrayBackedColumnSource
,BaseAggregateSlicedColumnSource
,BitMaskingColumnSource
,BitShiftingColumnSource
,BooleanAsByteColumnSource
,BooleanSparseArraySource.ReinterpretedAsByte
,ByteAggregateColumnSource
,ByteAsBooleanColumnSource
,ByteChunkColumnSource
,ByteSsmBackedSource
,CharAggregateColumnSource
,CharChunkColumnSource
,CharSsmBackedSource
,CrossJoinRightColumnSource
,DelegatingColumnSource
,DeltaAwareColumnSource
,DoubleAggregateColumnSource
,DoubleChunkColumnSource
,DoubleNullToZeroColumnSource
,DoubleSsmBackedSource
,FloatAggregateColumnSource
,FloatChunkColumnSource
,FloatSsmBackedSource
,HashTableColumnSource
,Immutable2DByteArraySource
,Immutable2DCharArraySource
,Immutable2DDoubleArraySource
,Immutable2DFloatArraySource
,Immutable2DIntArraySource
,Immutable2DLongArraySource
,Immutable2DNanosBasedTimeArraySource
,Immutable2DObjectArraySource
,Immutable2DShortArraySource
,ImmutableByteArraySource
,ImmutableCharArraySource
,ImmutableConstantByteSource
,ImmutableConstantCharSource
,ImmutableConstantDoubleSource
,ImmutableConstantFloatSource
,ImmutableConstantIntSource
,ImmutableConstantLongSource
,ImmutableConstantNanosBasedTimeSource
,ImmutableConstantObjectSource
,ImmutableConstantShortSource
,ImmutableDoubleArraySource
,ImmutableFloatArraySource
,ImmutableIntArraySource
,ImmutableLongArraySource
,ImmutableNanosBasedTimeArraySource
,ImmutableObjectArraySource
,ImmutableShortArraySource
,InstantSsmSourceWrapper
,IntAggregateColumnSource
,IntChunkColumnSource
,IntSsmBackedSource
,LocalDateWrapperSource
,LocalTimeWrapperSource
,LongAggregateColumnSource
,LongAsTimeSource
,LongChunkColumnSource
,LongSsmBackedSource
,MergeSortedHelper.SortedMergeColumnSource
,NanosBasedTimeArraySource
,NanosBasedTimeSparseArraySource
,NullValueColumnSource
,ObjectAggregateColumnSource
,ObjectChunkColumnSource
,ObjectSsmBackedSource
,PrevColumnSource
,RangeAggregateColumnSource
,RedirectedColumnSource
,ReversedColumnSource
,RowKeyColumnSource
,RowPositionColumnSource
,RowSetColumnSourceWrapper
,ShiftedColumnSource
,ShortAggregateColumnSource
,ShortChunkColumnSource
,ShortSsmBackedSource
,SingleValueColumnSource
,SingleValueObjectColumnSource
,SparseArrayColumnSource
,SwitchColumnSource
,SymbolTableToUniqueIdSource
,UnboxedLongBackedColumnSource
,UnboxedLongBackedColumnSource
,UnboxedTimeBackedColumnSource
,UngroupedColumnSource
,UnionColumnSource
,ViewColumnSource
public abstract class AbstractColumnSource<T>
extends Object
implements ColumnSource<T>, DefaultChunkSource.WithPrev<Values>
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
static class
Nested classes/interfaces inherited from interface io.deephaven.engine.table.ChunkSource
ChunkSource.FillContext, ChunkSource.GetContext, ChunkSource.WithPrev<ATTR extends Any>
Nested classes/interfaces inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource
DefaultChunkSource.SupportsContiguousGet<ATTR extends Any>, DefaultChunkSource.WithPrev<ATTR extends Any>
Nested classes/interfaces inherited from interface io.deephaven.engine.table.TupleExporter
TupleExporter.ExportElementFunction<TUPLE_TYPE>
-
Field Summary
Modifier and TypeFieldDescriptionprotected final Class<?>
protected final UpdateGraph
static final long
Minimum average run length in anRowSequence
that should triggerChunk
-filling by key ranges instead of individual keys.Fields inherited from interface io.deephaven.engine.table.ChunkSource
DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAY
Fields inherited from interface io.deephaven.engine.table.ChunkSource.WithPrev
ZERO_LENGTH_CHUNK_SOURCE_WITH_PREV_ARRAY
Fields inherited from interface io.deephaven.engine.table.ColumnSource
ZERO_LENGTH_COLUMN_SOURCE_ARRAY
-
Constructor Summary
ModifierConstructorDescriptionprotected
AbstractColumnSource
(@NotNull Class<T> type) AbstractColumnSource
(@NotNull Class<T> type, @Nullable Class<?> elementType) -
Method Summary
Modifier and TypeMethodDescription<ALTERNATE_DATA_TYPE>
booleanallowsReinterpret
(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Test if a reinterpret call will succeed.final void
defaultFillChunk
(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence) protected final void
defaultFillPrevChunk
(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence) protected <ALTERNATE_DATA_TYPE>
ColumnSource<ALTERNATE_DATA_TYPE>doReinterpret
(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Supply allowed reinterpret results.void
fillChunk
(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence) Populates the given destination chunk with data corresponding to the keys from the givenRowSequence
.void
fillPrevChunk
(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence) Populates the given destination chunk with data corresponding to the keys from the givenRowSequence
.Class<?>
getType()
match
(boolean invertMatch, boolean usePrev, boolean caseInsensitive, @Nullable DataIndex dataIndex, @NotNull RowSet mapper, Object... keys) Return arow set
where the values in the column source match the given keys.final <ALTERNATE_DATA_TYPE>
ColumnSource<ALTERNATE_DATA_TYPE>reinterpret
(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Provide an alternative view into the data underlying this column source.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface io.deephaven.engine.table.ColumnSource
cast, cast, createPreviousTuple, createTuple, createTupleFromValues, exportAllTo, exportElement, exportElement, getChunkType, isImmutable, isStateless, releaseCachedResources, startTrackingPrevValues, tupleLength
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource
getChunk, getChunk, getChunkByFilling, makeFillContext, makeGetContext
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource.WithPrev
getPrevChunk, getPrevChunk, getPrevChunkByFilling
Methods inherited from interface io.deephaven.engine.table.ElementSource
get, getBoolean, getByte, getChar, getDouble, getFloat, getInt, getLong, getPrev, getPrevBoolean, getPrevByte, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, getPrevShort, getShort
Methods inherited from interface io.deephaven.engine.table.FillContextMaker
makeFillContext
Methods inherited from interface io.deephaven.engine.table.GetContextMaker
makeGetContext
Methods inherited from interface io.deephaven.engine.table.TupleExporter
exportAllReinterpretedTo, exportAllReinterpretedTo, exportAllTo, exportElementReinterpreted
Methods inherited from interface io.deephaven.engine.table.TupleSource
createTupleFromReinterpretedValues
-
Field Details
-
USE_RANGES_AVERAGE_RUN_LENGTH
public static final long USE_RANGES_AVERAGE_RUN_LENGTHMinimum average run length in anRowSequence
that should triggerChunk
-filling by key ranges instead of individual keys.- See Also:
-
type
-
componentType
-
updateGraph
-
-
Constructor Details
-
AbstractColumnSource
-
AbstractColumnSource
-
-
Method Details
-
getType
- Specified by:
getType
in interfaceColumnSource<T>
-
getComponentType
- Specified by:
getComponentType
in interfaceColumnSource<T>
-
getPrevSource
- Specified by:
getPrevSource
in interfaceChunkSource.WithPrev<T>
- Specified by:
getPrevSource
in interfaceColumnSource<T>
- Specified by:
getPrevSource
in interfaceDefaultChunkSource.WithPrev<T>
- Returns:
- a chunk source which accesses the previous values.
-
match
public WritableRowSet match(boolean invertMatch, boolean usePrev, boolean caseInsensitive, @Nullable @Nullable DataIndex dataIndex, @NotNull @NotNull RowSet mapper, Object... keys) Description copied from interface:ColumnSource
Return arow set
where the values in the column source match the given keys.- Specified by:
match
in interfaceColumnSource<T>
- Parameters:
invertMatch
- Whether to invert the match, i.e. return the rows where the values do not match the given keysusePrev
- Whether to use the previous values for the ColumnSourcecaseInsensitive
- Whether to perform a case insensitive matchdataIndex
- An optional data index that can be used to accelerate the match (the index table must be included in snapshot controls or otherwise guaranteed to be current)mapper
- Restrict results to this row setkeys
- The keys to match in the column- Returns:
- The rows that match the given keys
-
fillChunk
public void fillChunk(@NotNull @NotNull ChunkSource.FillContext context, @NotNull @NotNull WritableChunk<? super Values> destination, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSource
Populates the given destination chunk with data corresponding to the keys from the givenRowSequence
.- Specified by:
fillChunk
in interfaceChunkSource<T>
- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk.destination
- The chunk to be populated according torowSequence
. No assumptions shall be made about the size of the chunk shall be made. The chunk will be populated from position [0,rowSequence.size()).rowSequence
- AnRowSequence
representing the keys to be fetched
-
defaultFillChunk
@VisibleForTesting public final void defaultFillChunk(@NotNull @NotNull ChunkSource.FillContext context, @NotNull @NotNull WritableChunk<? super Values> destination, @NotNull @NotNull RowSequence rowSequence) -
fillPrevChunk
public void fillPrevChunk(@NotNull @NotNull ChunkSource.FillContext context, @NotNull @NotNull WritableChunk<? super Values> destination, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSource.WithPrev
Populates the given destination chunk with data corresponding to the keys from the givenRowSequence
.- Specified by:
fillPrevChunk
in interfaceChunkSource.WithPrev<T>
- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk.destination
- The chunk to be populated according torowSequence
. No assumptions shall be made about the size of the chunk shall be made. The chunk will be populated from position [0,rowSequence.size()).rowSequence
- AnRowSequence
representing the keys to be fetched
-
defaultFillPrevChunk
protected final void defaultFillPrevChunk(@NotNull @NotNull ChunkSource.FillContext context, @NotNull @NotNull WritableChunk<? super Values> destination, @NotNull @NotNull RowSequence rowSequence) -
allowsReinterpret
public <ALTERNATE_DATA_TYPE> boolean allowsReinterpret(@NotNull @NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Description copied from interface:ColumnSource
Test if a reinterpret call will succeed.- Specified by:
allowsReinterpret
in interfaceColumnSource<T>
- Parameters:
alternateDataType
- The alternative type to consider- Returns:
- If a reinterpret on this column source with the supplied alternateDataType will succeed.
-
reinterpret
public final <ALTERNATE_DATA_TYPE> ColumnSource<ALTERNATE_DATA_TYPE> reinterpret(@NotNull @NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) throws IllegalArgumentException Description copied from interface:ColumnSource
Provide an alternative view into the data underlying this column source.- Specified by:
reinterpret
in interfaceColumnSource<T>
- Parameters:
alternateDataType
- The alternative type to expose- Returns:
- A column source of the alternate data type, backed by the same underlying data.
- Throws:
IllegalArgumentException
- If the alternativeDataType supplied is not supported
-
doReinterpret
protected <ALTERNATE_DATA_TYPE> ColumnSource<ALTERNATE_DATA_TYPE> doReinterpret(@NotNull @NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Supply allowed reinterpret results. The default implementation handles the most common case to avoid code duplication.- Parameters:
alternateDataType
- The alternate data type- Returns:
- The resulting
ColumnSource
-