Class UnionColumnSource<T>
java.lang.Object
io.deephaven.engine.table.impl.AbstractColumnSource<T>
io.deephaven.engine.table.impl.sources.UnionColumnSource<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>
ColumnSource implementation for
TableTools.merge(java.util.List<io.deephaven.engine.table.Table>)
results.-
Nested Class Summary
Nested classes/interfaces inherited from class io.deephaven.engine.table.impl.AbstractColumnSource
AbstractColumnSource.DefaultedImmutable<DATA_TYPE>, AbstractColumnSource.DefaultedMutable<DATA_TYPE>
Nested classes/interfaces inherited from interface io.deephaven.engine.table.ChunkSource
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
Fields inherited from class io.deephaven.engine.table.impl.AbstractColumnSource
componentType, type, updateGraph, USE_RANGES_AVERAGE_RUN_LENGTH
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
-
Method Summary
Modifier and TypeMethodDescription<ALTERNATE_DATA_TYPE>
booleanallowsReinterpret
(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Test if a reinterpret call will succeed.protected <ALTERNATE_DATA_TYPE>
ColumnSource<ALTERNATE_DATA_TYPE>doReinterpret
(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Supply allowed reinterpret results.void
fillChunk
(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
(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
.get
(long rowKey) Get the value from the source.getBoolean
(long rowKey) Get the value at the rowKey as a Boolean.byte
getByte
(long rowKey) Get the value at the rowKey as a byte.char
getChar
(long rowKey) Get the value at the rowKey as a char.getChunk
(ChunkSource.GetContext context, long firstKey, long lastKey) Same asChunkSource.getChunk(GetContext, RowSequence)
, except that you pass in the begin and last keys representing the begin and last (inclusive) keys of a single range rather than anRowSequence
.getChunk
(ChunkSource.GetContext context, @NotNull RowSequence rowSequence) Returns a chunk of data corresponding to the keys from the givenRowSequence
.double
getDouble
(long rowKey) Get the value at the rowKey as a double.float
getFloat
(long rowKey) Get the value at the rowKey as a float.int
getInt
(long rowKey) Get the value at the rowKey as an int.long
getLong
(long rowKey) Get the value at the rowKey as a long.getPrev
(long rowKey) Get the previous value at the rowKey.getPrevBoolean
(long rowKey) Get the previous value at the rowKey as a Boolean.byte
getPrevByte
(long rowKey) Get the previous value at the rowKey as a byte.char
getPrevChar
(long rowKey) Get the previous value at the rowKey as a char.getPrevChunk
(ChunkSource.GetContext context, long firstKey, long lastKey) Same asChunkSource.WithPrev.getPrevChunk(GetContext, RowSequence)
, except that you pass in the begin and last keys representing the begin and last (inclusive) keys of a single range rather than anRowSequence
.getPrevChunk
(ChunkSource.GetContext context, @NotNull RowSequence rowSequence) Returns a chunk of previous data corresponding to the keys from the givenRowSequence
.double
getPrevDouble
(long rowKey) Get the previous value at the rowKey as a double.float
getPrevFloat
(long rowKey) Get the previous value at the rowKey as a float.int
getPrevInt
(long rowKey) Get the previous value at the rowKey as an int.long
getPrevLong
(long rowKey) Get the previous value at the rowKey as a long.short
getPrevShort
(long rowKey) Get the previous value at the rowKey as a short.short
getShort
(long rowKey) Get the value at the rowKey as a short.getSubSource
(int slot) Return the Union source manager that was used to create this table.boolean
Determine if this column source is immutable, meaning that the values at a given row key never change.boolean
Most column sources will return the same value for a given row without respect to the order that the rows are read.makeFillContext
(int chunkCapacity, SharedContext sharedContext) Allocate a newChunkSource.FillContext
for filling chunks from thisFillContextMaker
, typically aChunkSource
.makeGetContext
(int chunkCapacity, SharedContext sharedContext) Allocate a newChunkSource.GetContext
for retrieving chunks from thisGetContextMaker
, typically aChunkSource
.Methods inherited from class io.deephaven.engine.table.impl.AbstractColumnSource
defaultFillChunk, defaultFillPrevChunk, getComponentType, getPrevSource, getType, match, reinterpret
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, releaseCachedResources, startTrackingPrevValues, tupleLength
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource
getChunkByFilling
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource.WithPrev
getPrevChunkByFilling
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
-
Method Details
-
get
Description copied from interface:ElementSource
Get the value from the source. This may return boxed values for basic types. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the value at the rowKey, potentially null.
-
getBoolean
Description copied from interface:ElementSource
Get the value at the rowKey as a Boolean. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the boolean at the rowKey, potentially null.
-
getByte
public byte getByte(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a byte. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the boolean at the rowKey, null values are represented by
QueryConstants.NULL_BYTE
-
getChar
public char getChar(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a char. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the char at the rowKey, null values are represented by
QueryConstants.NULL_CHAR
-
getDouble
public double getDouble(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a double. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the double at the rowKey, null values are represented by
QueryConstants.NULL_DOUBLE
-
getFloat
public float getFloat(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a float. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the float at the rowKey, null values are represented by
QueryConstants.NULL_FLOAT
-
getInt
public int getInt(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as an int. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the int at the rowKey, null values are represented by
QueryConstants.NULL_INT
-
getLong
public long getLong(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a long. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the long at the rowKey, null values are represented by
QueryConstants.NULL_LONG
-
getShort
public short getShort(long rowKey) Description copied from interface:ElementSource
Get the value at the rowKey as a short. RowKeys that are not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the short at the rowKey, null values are represented by
QueryConstants.NULL_SHORT
-
getPrev
Description copied from interface:ElementSource
Get the previous value at the rowKey. Previous values are used during anUG
update
cycle to process changes in data. Duringnormal
operation previous values will be identical tocurrent
values. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the previous value at the rowKey, potentially null.
-
getPrevBoolean
Description copied from interface:ElementSource
Get the previous value at the rowKey as a Boolean. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous boolean at the rowKey, potentially null.
-
getPrevByte
public byte getPrevByte(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a byte. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous boolean at the rowKey, null values are represented by
QueryConstants.NULL_BYTE
-
getPrevChar
public char getPrevChar(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a char. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- ohe location in key space to get the previous value from.- Returns:
- the previous char at the rowKey, null values are represented by
QueryConstants.NULL_CHAR
-
getPrevDouble
public double getPrevDouble(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a double. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous double at the rowKey, null values are represented by
QueryConstants.NULL_DOUBLE
-
getPrevFloat
public float getPrevFloat(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a float. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous float at the rowKey, null values are represented by
QueryConstants.NULL_FLOAT
-
getPrevInt
public int getPrevInt(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as an int. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous int at the rowKey, null values are represented by
QueryConstants.NULL_INT
-
getPrevLong
public long getPrevLong(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a long. SeeElementSource.getPrev(long)
for more details.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous long at the rowKey, null values are represented by
QueryConstants.NULL_LONG
-
getPrevShort
public short getPrevShort(long rowKey) Description copied from interface:ElementSource
Get the previous value at the rowKey as a short. SeeElementSource.getPrev(long)
for more details. RowKeys that were not present are undefined.- Parameters:
rowKey
- the location in key space to get the previous value from.- Returns:
- the previous short at the rowKey, null values are represented by
QueryConstants.NULL_SHORT
-
fillChunk
public void fillChunk(@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>
- Overrides:
fillChunk
in classAbstractColumnSource<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
-
fillPrevChunk
public void fillPrevChunk(@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>
- Overrides:
fillPrevChunk
in classAbstractColumnSource<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
-
getChunk
public Chunk<? extends Values> getChunk(@NotNull ChunkSource.GetContext context, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSource
Returns a chunk of data corresponding to the keys from the givenRowSequence
.- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk. In particular, the Context may be used to provide a Chunk data poolrowSequence
- AnRowSequence
representing the keys to be fetched- Returns:
- A chunk of data corresponding to the keys from the given
RowSequence
-
getChunk
public Chunk<? extends Values> getChunk(@NotNull ChunkSource.GetContext context, long firstKey, long lastKey) Description copied from interface:ChunkSource
Same asChunkSource.getChunk(GetContext, RowSequence)
, except that you pass in the begin and last keys representing the begin and last (inclusive) keys of a single range rather than anRowSequence
. Typically you want to call this only if you don't have anRowSequence
, such as during anRowSequence.forAllRowKeyRanges(LongRangeConsumer)
call. In this case, it allows you to avoid creating an intermediaryRowSequence
object.- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk. In particular, the Context may be used to provide a Chunk data poolfirstKey
- The beginning key (inclusive) of the range to fetch in the chunklastKey
- The last key (inclusive) of the range to fetch in the chunk
-
getPrevChunk
public Chunk<? extends Values> getPrevChunk(@NotNull ChunkSource.GetContext context, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSource.WithPrev
Returns a chunk of previous data corresponding to the keys from the givenRowSequence
.- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk. In particular, the Context may be used to provide a Chunk data poolrowSequence
- AnRowSequence
representing the keys to be fetched- Returns:
- A chunk of data corresponding to the keys from the given
RowSequence
-
getPrevChunk
public Chunk<? extends Values> getPrevChunk(@NotNull ChunkSource.GetContext context, long firstKey, long lastKey) Description copied from interface:ChunkSource.WithPrev
Same asChunkSource.WithPrev.getPrevChunk(GetContext, RowSequence)
, except that you pass in the begin and last keys representing the begin and last (inclusive) keys of a single range rather than anRowSequence
. -
getUnionSourceManager
Return the Union source manager that was used to create this table. -
getSubSource
-
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>
- Overrides:
allowsReinterpret
in classAbstractColumnSource<T>
- Parameters:
alternateDataType
- The alternative type to consider- Returns:
- If a reinterpret on this column source with the supplied alternateDataType will succeed.
-
doReinterpret
protected <ALTERNATE_DATA_TYPE> ColumnSource<ALTERNATE_DATA_TYPE> doReinterpret(@NotNull @NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Description copied from class:AbstractColumnSource
Supply allowed reinterpret results. The default implementation handles the most common case to avoid code duplication.- Overrides:
doReinterpret
in classAbstractColumnSource<T>
- Parameters:
alternateDataType
- The alternate data type- Returns:
- The resulting
ColumnSource
-
isImmutable
public boolean isImmutable()Description copied from interface:ColumnSource
Determine if this column source is immutable, meaning that the values at a given row key never change.- Returns:
- true if the values at a given row key of the column source never change, false otherwise
-
isStateless
public boolean isStateless()Description copied from interface:ColumnSource
Most column sources will return the same value for a given row without respect to the order that the rows are read. Those columns sources are considered "stateless" and should return true. Some column sources, however may be dependent on evaluation order. For example, a formula that updates a Map must be evaluated from the first row to the last row. A column source that has the potential to depend on the order of evaluation must return false.- Returns:
- true if this is a stateless column source
-