Class BooleanArraySource
java.lang.Object
io.deephaven.engine.table.impl.AbstractColumnSource<T>
io.deephaven.engine.table.impl.sources.ArrayBackedColumnSource<T>
io.deephaven.engine.table.impl.sources.BooleanArraySource
- All Implemented Interfaces:
ChunkSink<Values>
,ChunkSource<Values>
,ChunkSource.WithPrev<Values>
,ColumnSource<Boolean>
,ElementSource<Boolean>
,FillContextMaker
,GetContextMaker
,ColumnSourceGetDefaults.ForBoolean
,DefaultChunkSource<Values>
,DefaultChunkSource.WithPrev<Values>
,MutableColumnSource<Boolean>
,MutableColumnSourceGetDefaults.ForBoolean
,ChunkedBackingStoreExposedWritableSource
,FillUnordered<Values>
,InMemoryColumnSource
,Releasable
,TupleExporter<Boolean>
,TupleSource<Boolean>
,WritableColumnSource<Boolean>
,WritableSourceWithPrepareForParallelPopulation
public class BooleanArraySource
extends ArrayBackedColumnSource<T>
implements MutableColumnSourceGetDefaults.ForBoolean
TODO: Re-implement this with better compression (only need 2 bits per value, or we can pack 5 values into 1 byte if
we're feeling fancy).
-
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.ChunkSink
ChunkSink.FillFromContext
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>
Nested classes/interfaces inherited from interface io.deephaven.engine.table.WritableColumnSource
WritableColumnSource.ByteFiller, WritableColumnSource.CharFiller, WritableColumnSource.DoubleFiller, WritableColumnSource.FloatFiller, WritableColumnSource.IntFiller, WritableColumnSource.LongFiller, WritableColumnSource.ObjectFiller, WritableColumnSource.ShortFiller, WritableColumnSource.SinkFiller
-
Field Summary
Modifier and TypeFieldDescriptionprotected long
If ensure previous has been called, we need not check previous values when filling.protected gnu.trove.list.array.TIntArrayList
protected UpdateCommitter<io.deephaven.engine.table.impl.sources.ArraySourceHelper<Boolean,
byte[]>> The presence of a prevFlusher means that this ArraySource wants to track previous values.Fields inherited from class io.deephaven.engine.table.impl.sources.ArrayBackedColumnSource
BLOCK_SIZE
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.ChunkSink
DEFAULT_FILL_FROM_INSTANCE
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
Fields inherited from interface io.deephaven.engine.table.impl.sources.InMemoryColumnSource
TWO_DIMENSIONAL_COLUMN_SOURCE_THRESHOLD
-
Constructor Summary
-
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
ensureCapacity
(long capacity, boolean nullFill) Ensure that this WritableColumnSource can accept row keys in range[0, capacity)
.boolean
Does this column source provide a chunked exposed backing store?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
fillFromChunk
(@NotNull ChunkSink.FillFromContext context, @NotNull Chunk<? extends Values> src, @NotNull RowSequence rowSequence) Our default, inefficient, implementation.void
fillFromChunkUnordered
(@NotNull ChunkSink.FillFromContext context, @NotNull Chunk<? extends Values> src, @NotNull LongChunk<RowKeys> keys) Fills the ChunkSink with data from the source, with data corresponding to the keys from the given key chunk.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
.protected void
fillSparseChunk
(@NotNull WritableChunk<? super Values> destGeneric, @NotNull RowSequence indices) protected void
fillSparseChunkUnordered
(@NotNull WritableChunk<? super Values> destGeneric, @NotNull LongChunk<? extends RowKeys> indices) protected void
fillSparsePrevChunk
(@NotNull WritableChunk<? super Values> destGeneric, @NotNull RowSequence indices) protected void
fillSparsePrevChunkUnordered
(@NotNull WritableChunk<? super Values> destGeneric, @NotNull LongChunk<? extends RowKeys> indices) get
(long rowKey) Get the value from the source.final byte
getAndSetUnsafe
(long rowKey, byte newValue) final Boolean
getAndSetUnsafe
(long rowKey, Boolean newValue) byte
getByte
(long rowKey) Get the value at the rowKey as a byte.final long
Get the capacity of this column source.getChunk
(@NotNull ChunkSource.GetContext context, @NotNull RowSequence rowSequence) Returns a chunk of data corresponding to the keys from the givenRowSequence
.getPrev
(long rowKey) Get the previous value at the rowKey.byte
getPrevByte
(long rowKey) Get the previous value at the rowKey as a byte.getPrevChunk
(@NotNull ChunkSource.GetContext context, @NotNull RowSequence rowSequence) Returns a chunk of previous data corresponding to the keys from the givenRowSequence
.getUnsafe
(long rowKey) makeFillContext
(int chunkCapacity, SharedContext sharedContext) Allocate a newChunkSource.FillContext
for filling chunks from thisFillContextMaker
, typically aChunkSource
.makeFillFromContext
(int chunkCapacity) void
prepareForParallelPopulation
(RowSequence changedIndices) This version of `prepareForParallelPopulation` will internally callensureCapacity(long, boolean)
to make sure there is room for the incoming values.long
resetWritableChunkToBackingStore
(@NotNull ResettableWritableChunk<?> chunk, long position) Resets the given chunk to provide a write-through reference to our backing array.long
resetWritableChunkToBackingStoreSlice
(@NotNull ResettableWritableChunk<?> chunk, long position) Resets the given chunk to provide a write-through reference to our backing array.void
set
(long key, byte value) void
void
setNull
(long key) void
Force my inheritors to implement this method, rather than taking the interface default.Methods inherited from class io.deephaven.engine.table.impl.sources.ArrayBackedColumnSource
fillChunkUnordered, fillPrevChunkUnordered, from, from, getBooleanMemoryColumnSource, getInstantMemoryColumnSource, getInstantMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSourceUntyped, getMemoryColumnSourceUntyped, isImmutable, providesFillUnordered, set, set, set, set, set, set
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, cast, cast, createPreviousTuple, createTuple, createTupleFromValues, exportAllTo, exportElement, exportElement, getChunkType, getComponentType, getPrevSource, getType, isStateless, match, reinterpret, releaseCachedResources, tupleLength
Methods inherited from interface io.deephaven.engine.table.impl.ColumnSourceGetDefaults.ForBoolean
getBoolean, getChar, getDouble, getFloat, getInt, getLong, getShort
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource
getChunk, getChunkByFilling, makeGetContext
Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource.WithPrev
getPrevChunk, 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.impl.sources.InMemoryColumnSource
isInMemory
Methods inherited from interface io.deephaven.engine.table.impl.MutableColumnSource
isImmutable
Methods inherited from interface io.deephaven.engine.table.impl.MutableColumnSourceGetDefaults.ForBoolean
getPrevBoolean, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, getPrevShort
Methods inherited from interface io.deephaven.engine.table.TupleExporter
exportAllReinterpretedTo, exportAllReinterpretedTo, exportAllTo, exportElementReinterpreted
Methods inherited from interface io.deephaven.engine.table.TupleSource
createTupleFromReinterpretedValues
Methods inherited from interface io.deephaven.engine.table.WritableColumnSource
ensureCapacity, setNull
-
Field Details
-
prevFlusher
protected transient UpdateCommitter<io.deephaven.engine.table.impl.sources.ArraySourceHelper<Boolean,byte[]>> prevFlusherThe presence of a prevFlusher means that this ArraySource wants to track previous values. If prevFlusher is null, the ArraySource does not want (or does not yet want) to track previous values. Deserialized ArraySources never track previous values. -
prevAllocated
protected transient gnu.trove.list.array.TIntArrayList prevAllocated -
ensurePreviousClockCycle
protected transient long ensurePreviousClockCycleIf ensure previous has been called, we need not check previous values when filling.
-
-
Constructor Details
-
BooleanArraySource
public BooleanArraySource()
-
-
Method Details
-
startTrackingPrevValues
public void startTrackingPrevValues()Force my inheritors to implement this method, rather than taking the interface default.- Specified by:
startTrackingPrevValues
in interfaceColumnSource<Boolean>
-
ensureCapacity
public void ensureCapacity(long capacity, boolean nullFill) Description copied from interface:WritableColumnSource
Ensure that this WritableColumnSource can accept row keys in range[0, capacity)
.- Specified by:
ensureCapacity
in interfaceWritableColumnSource<Boolean>
- Specified by:
ensureCapacity
in classArrayBackedColumnSource<Boolean>
- Parameters:
capacity
- The new minimum capacitynullFill
- Whether data should be "null-filled". If true, get operations at row keys that have not been set will return the appropriate null value; otherwise such gets produce undefined results.
-
prepareForParallelPopulation
This version of `prepareForParallelPopulation` will internally callensureCapacity(long, boolean)
to make sure there is room for the incoming values.- Specified by:
prepareForParallelPopulation
in interfaceWritableSourceWithPrepareForParallelPopulation
- Parameters:
changedIndices
- indices in the dense table
-
setNull
public void setNull(long key) - Specified by:
setNull
in interfaceWritableColumnSource<Boolean>
-
set
- Specified by:
set
in interfaceWritableColumnSource<Boolean>
-
set
public void set(long key, byte value) - Specified by:
set
in interfaceWritableColumnSource<Boolean>
- Overrides:
set
in classArrayBackedColumnSource<Boolean>
-
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.- Specified by:
get
in interfaceElementSource<Boolean>
- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the value at the rowKey, potentially null.
-
getUnsafe
-
getAndSetUnsafe
-
getAndSetUnsafe
public final byte getAndSetUnsafe(long rowKey, byte newValue) -
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.- Specified by:
getByte
in interfaceColumnSourceGetDefaults.ForBoolean
- Specified by:
getByte
in interfaceElementSource<Boolean>
- 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
-
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.- Specified by:
getPrevByte
in interfaceElementSource<Boolean>
- Specified by:
getPrevByte
in interfaceMutableColumnSourceGetDefaults.ForBoolean
- 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
-
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.- Specified by:
getPrev
in interfaceElementSource<Boolean>
- Parameters:
rowKey
- the location in key space to get the value from.- Returns:
- the previous value at the rowKey, potentially null.
-
fillSparseChunk
protected void fillSparseChunk(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull RowSequence indices) - Specified by:
fillSparseChunk
in classArrayBackedColumnSource<Boolean>
-
fillSparsePrevChunk
protected void fillSparsePrevChunk(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull RowSequence indices) - Specified by:
fillSparsePrevChunk
in classArrayBackedColumnSource<Boolean>
-
fillSparseChunkUnordered
protected void fillSparseChunkUnordered(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull LongChunk<? extends RowKeys> indices) - Specified by:
fillSparseChunkUnordered
in classArrayBackedColumnSource<Boolean>
-
fillSparsePrevChunkUnordered
protected void fillSparsePrevChunkUnordered(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull LongChunk<? extends RowKeys> indices) - Specified by:
fillSparsePrevChunkUnordered
in classArrayBackedColumnSource<Boolean>
-
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<Values>
- Overrides:
fillChunk
in classAbstractColumnSource<Boolean>
- 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
-
exposesChunkedBackingStore
public boolean exposesChunkedBackingStore()Description copied from interface:ChunkedBackingStoreExposedWritableSource
Does this column source provide a chunked exposed backing store?- Specified by:
exposesChunkedBackingStore
in interfaceChunkedBackingStoreExposedWritableSource
- Returns:
- true if this column source provides a chunked backing store, false otherwise
-
resetWritableChunkToBackingStore
public long resetWritableChunkToBackingStore(@NotNull @NotNull ResettableWritableChunk<?> chunk, long position) Description copied from interface:ChunkedBackingStoreExposedWritableSource
Resets the given chunk to provide a write-through reference to our backing array.Note: This is unsafe to use if previous tracking has been enabled!
- Specified by:
resetWritableChunkToBackingStore
in interfaceChunkedBackingStoreExposedWritableSource
- Parameters:
chunk
- the writable chunk to reset to our backing array.position
- position that we require- Returns:
- the first position addressable by the chunk
-
resetWritableChunkToBackingStoreSlice
public long resetWritableChunkToBackingStoreSlice(@NotNull @NotNull ResettableWritableChunk<?> chunk, long position) Description copied from interface:ChunkedBackingStoreExposedWritableSource
Resets the given chunk to provide a write-through reference to our backing array.Note: This is unsafe to use if previous tracking has been enabled!
- Specified by:
resetWritableChunkToBackingStoreSlice
in interfaceChunkedBackingStoreExposedWritableSource
- Parameters:
chunk
- the writable chunk to reset to a slice of our backing array.position
- position of the first value in the returned chunk- Returns:
- the capacity of the returned chunk
-
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<Values>
- Overrides:
fillPrevChunk
in classAbstractColumnSource<Boolean>
- 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<Values> getChunk(@NotNull @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
.- Specified by:
getChunk
in interfaceChunkSource<Values>
- Specified by:
getChunk
in interfaceDefaultChunkSource<Values>
- Overrides:
getChunk
in classArrayBackedColumnSource<Boolean>
- 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<Values> getPrevChunk(@NotNull @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
.- Specified by:
getPrevChunk
in interfaceChunkSource.WithPrev<Values>
- Specified by:
getPrevChunk
in interfaceDefaultChunkSource.WithPrev<Values>
- 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
-
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<Boolean>
- Overrides:
allowsReinterpret
in classAbstractColumnSource<Boolean>
- 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<Boolean>
- Parameters:
alternateDataType
- The alternate data type- Returns:
- The resulting
ColumnSource
-
fillFromChunkUnordered
public void fillFromChunkUnordered(@NotNull @NotNull ChunkSink.FillFromContext context, @NotNull @NotNull Chunk<? extends Values> src, @NotNull @NotNull LongChunk<RowKeys> keys) Description copied from interface:ChunkSink
Fills the ChunkSink with data from the source, with data corresponding to the keys from the given key chunk.- Specified by:
fillFromChunkUnordered
in interfaceChunkSink<Values>
- Specified by:
fillFromChunkUnordered
in interfaceWritableColumnSource<Boolean>
- Parameters:
context
- A context containing all mutable/state related data used in writing the Chunk.src
- The source of the dataRowSequence
keys
- ALongChunk
representing the keys to be written
-
getCapacity
public final long getCapacity()Get the capacity of this column source. This number is one higher than the highest key that may be accessed (read or written).- Returns:
- The capacity of this column source
-
makeFillFromContext
Description copied from interface:WritableColumnSource
Provide a default, emptyChunkSink.FillFromContext
for use with our defaultWritableColumnSource.fillFromChunk(io.deephaven.engine.table.ChunkSink.FillFromContext, io.deephaven.chunk.Chunk<? extends io.deephaven.chunk.attributes.Values>, io.deephaven.engine.rowset.RowSequence)
.- Specified by:
makeFillFromContext
in interfaceChunkSink<T>
- Specified by:
makeFillFromContext
in interfaceWritableColumnSource<T>
-
fillFromChunk
public void fillFromChunk(@NotNull @NotNull ChunkSink.FillFromContext context, @NotNull @NotNull Chunk<? extends Values> src, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:WritableColumnSource
Our default, inefficient, implementation. Inheritors who care should provide a better implementation.- Specified by:
fillFromChunk
in interfaceChunkSink<T>
- Specified by:
fillFromChunk
in interfaceWritableColumnSource<T>
- Parameters:
context
- A context containing all mutable/state related data used in writing the Chunk.src
- The source of the datarowSequence
rowSequence
- AnRowSequence
representing the keys to be written
-