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,PushdownFilterMatcher,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.FillFromContextNested 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
FieldsModifier and TypeFieldDescriptionprotected longIf ensure previous has been called, we need not check previous values when filling.protected gnu.trove.list.array.TIntArrayListprotected 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_SIZEFields inherited from class io.deephaven.engine.table.impl.AbstractColumnSource
componentType, type, updateGraph, USE_RANGES_AVERAGE_RUN_LENGTHFields inherited from interface io.deephaven.engine.table.ChunkSink
DEFAULT_FILL_FROM_INSTANCEFields inherited from interface io.deephaven.engine.table.ChunkSource
DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAYFields inherited from interface io.deephaven.engine.table.ChunkSource.WithPrev
ZERO_LENGTH_CHUNK_SOURCE_WITH_PREV_ARRAYFields inherited from interface io.deephaven.engine.table.ColumnSource
ZERO_LENGTH_COLUMN_SOURCE_ARRAYFields inherited from interface io.deephaven.engine.table.impl.sources.InMemoryColumnSource
TWO_DIMENSIONAL_COLUMN_SOURCE_THRESHOLD -
Constructor Summary
Constructors -
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.voidensureCapacity(long capacity, boolean nullFill) Ensure that this WritableColumnSource can accept row keys in range[0, capacity).booleanDoes this column source provide a chunked exposed backing store?voidfillChunk(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.voidfillFromChunk(@NotNull ChunkSink.FillFromContext context, @NotNull Chunk<? extends Values> src, @NotNull RowSequence rowSequence) Our default, inefficient, implementation.voidfillFromChunkUnordered(@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.voidfillPrevChunk(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 voidfillSparseChunk(@NotNull WritableChunk<? super Values> destGeneric, @NotNull RowSequence indices) protected voidfillSparseChunkUnordered(@NotNull WritableChunk<? super Values> destGeneric, @NotNull LongChunk<? extends RowKeys> indices) protected voidfillSparsePrevChunk(@NotNull WritableChunk<? super Values> destGeneric, @NotNull RowSequence indices) protected voidfillSparsePrevChunkUnordered(@NotNull WritableChunk<? super Values> destGeneric, @NotNull LongChunk<? extends RowKeys> indices) get(long rowKey) Get the value from the source.final bytegetAndSetUnsafe(long rowKey, byte newValue) final BooleangetAndSetUnsafe(long rowKey, Boolean newValue) bytegetByte(long rowKey) Get the value at the rowKey as a byte.final longGet 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.bytegetPrevByte(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.FillContextfor filling chunks from thisFillContextMaker, typically aChunkSource.makeFillFromContext(int chunkCapacity) voidprepareForParallelPopulation(RowSequence changedIndices) This version of `prepareForParallelPopulation` will internally callensureCapacity(long, boolean)to make sure there is room for the incoming values.longresetWritableChunkToBackingStore(@NotNull ResettableWritableChunk<?> chunk, long position) Resets the given chunk to provide a write-through reference to our backing array.longresetWritableChunkToBackingStoreSlice(@NotNull ResettableWritableChunk<?> chunk, long position) Resets the given chunk to provide a write-through reference to our backing array.voidset(long key, byte value) voidvoidsetNull(long key) voidForce 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, setMethods inherited from class io.deephaven.engine.table.impl.AbstractColumnSource
defaultFillChunk, defaultFillPrevChunk, estimatePushdownFilterCost, getComponentType, getPrevSource, getType, makePushdownFilterContext, match, pushdownFilter, pushdownManager, reinterpretMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods 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, tupleLengthMethods inherited from interface io.deephaven.engine.table.impl.ColumnSourceGetDefaults.ForBoolean
getBoolean, getChar, getDouble, getFloat, getInt, getLong, getShortMethods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource
getChunk, getChunkByFilling, makeGetContextMethods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource.WithPrev
getPrevChunk, getPrevChunkByFillingMethods inherited from interface io.deephaven.engine.table.FillContextMaker
makeFillContextMethods inherited from interface io.deephaven.engine.table.GetContextMaker
makeGetContextMethods inherited from interface io.deephaven.engine.table.impl.sources.InMemoryColumnSource
isInMemoryMethods inherited from interface io.deephaven.engine.table.impl.MutableColumnSource
isImmutableMethods inherited from interface io.deephaven.engine.table.impl.MutableColumnSourceGetDefaults.ForBoolean
getPrevBoolean, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, getPrevShortMethods inherited from interface io.deephaven.engine.table.TupleExporter
exportAllReinterpretedTo, exportAllReinterpretedTo, exportAllTo, exportElementReinterpretedMethods inherited from interface io.deephaven.engine.table.TupleSource
createTupleFromReinterpretedValuesMethods 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:
startTrackingPrevValuesin interfaceColumnSource<Boolean>
-
ensureCapacity
public void ensureCapacity(long capacity, boolean nullFill) Description copied from interface:WritableColumnSourceEnsure that this WritableColumnSource can accept row keys in range[0, capacity).- Specified by:
ensureCapacityin interfaceWritableColumnSource<Boolean>- Specified by:
ensureCapacityin 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:
prepareForParallelPopulationin interfaceWritableSourceWithPrepareForParallelPopulation- Parameters:
changedIndices- indices in the dense table
-
setNull
public void setNull(long key) - Specified by:
setNullin interfaceWritableColumnSource<Boolean>
-
set
- Specified by:
setin interfaceWritableColumnSource<Boolean>
-
set
public void set(long key, byte value) - Specified by:
setin interfaceWritableColumnSource<Boolean>- Overrides:
setin classArrayBackedColumnSource<Boolean>
-
get
Description copied from interface:ElementSourceGet the value from the source. This may return boxed values for basic types. RowKeys that are not present are undefined.- Specified by:
getin 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:ElementSourceGet the value at the rowKey as a byte. RowKeys that are not present are undefined.- Specified by:
getBytein interfaceColumnSourceGetDefaults.ForBoolean- Specified by:
getBytein 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:ElementSourceGet the previous value at the rowKey as a byte. SeeElementSource.getPrev(long)for more details. RowKeys that were not present are undefined.- Specified by:
getPrevBytein interfaceElementSource<Boolean>- Specified by:
getPrevBytein 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:ElementSourceGet the previous value at the rowKey. Previous values are used during anUGupdatecycle to process changes in data. Duringnormaloperation previous values will be identical tocurrentvalues. RowKeys that were not present are undefined.- Specified by:
getPrevin 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:
fillSparseChunkin classArrayBackedColumnSource<Boolean>
-
fillSparsePrevChunk
protected void fillSparsePrevChunk(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull RowSequence indices) - Specified by:
fillSparsePrevChunkin classArrayBackedColumnSource<Boolean>
-
fillSparseChunkUnordered
protected void fillSparseChunkUnordered(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull LongChunk<? extends RowKeys> indices) - Specified by:
fillSparseChunkUnorderedin classArrayBackedColumnSource<Boolean>
-
fillSparsePrevChunkUnordered
protected void fillSparsePrevChunkUnordered(@NotNull @NotNull WritableChunk<? super Values> destGeneric, @NotNull @NotNull LongChunk<? extends RowKeys> indices) - Specified by:
fillSparsePrevChunkUnorderedin classArrayBackedColumnSource<Boolean>
-
fillChunk
public void fillChunk(@NotNull ChunkSource.FillContext context, @NotNull @NotNull WritableChunk<? super Values> destination, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSourcePopulates the given destination chunk with data corresponding to the keys from the givenRowSequence.- Specified by:
fillChunkin interfaceChunkSource<Values>- Overrides:
fillChunkin 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- AnRowSequencerepresenting the keys to be fetched
-
exposesChunkedBackingStore
public boolean exposesChunkedBackingStore()Description copied from interface:ChunkedBackingStoreExposedWritableSourceDoes this column source provide a chunked exposed backing store?- Specified by:
exposesChunkedBackingStorein 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:ChunkedBackingStoreExposedWritableSourceResets 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:
resetWritableChunkToBackingStorein 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:ChunkedBackingStoreExposedWritableSourceResets 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:
resetWritableChunkToBackingStoreSlicein 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.WithPrevPopulates the given destination chunk with data corresponding to the keys from the givenRowSequence.- Specified by:
fillPrevChunkin interfaceChunkSource.WithPrev<Values>- Overrides:
fillPrevChunkin 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- AnRowSequencerepresenting the keys to be fetched
-
getChunk
public Chunk<Values> getChunk(@NotNull @NotNull ChunkSource.GetContext context, @NotNull @NotNull RowSequence rowSequence) Description copied from interface:ChunkSourceReturns a chunk of data corresponding to the keys from the givenRowSequence.- Specified by:
getChunkin interfaceChunkSource<Values>- Specified by:
getChunkin interfaceDefaultChunkSource<Values>- Overrides:
getChunkin 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- AnRowSequencerepresenting 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.WithPrevReturns a chunk of previous data corresponding to the keys from the givenRowSequence.- Specified by:
getPrevChunkin interfaceChunkSource.WithPrev<Values>- Specified by:
getPrevChunkin 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- AnRowSequencerepresenting 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:ColumnSourceTest if a reinterpret call will succeed.- Specified by:
allowsReinterpretin interfaceColumnSource<Boolean>- Overrides:
allowsReinterpretin 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:AbstractColumnSourceSupply allowed reinterpret results. The default implementation handles the most common case to avoid code duplication.- Overrides:
doReinterpretin 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:ChunkSinkFills the ChunkSink with data from the source, with data corresponding to the keys from the given key chunk.- Specified by:
fillFromChunkUnorderedin interfaceChunkSink<Values>- Specified by:
fillFromChunkUnorderedin interfaceWritableColumnSource<Boolean>- Parameters:
context- A context containing all mutable/state related data used in writing the Chunk.src- The source of the dataRowSequencekeys- ALongChunkrepresenting 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:WritableColumnSourceProvide a default, emptyChunkSink.FillFromContextfor 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:
makeFillFromContextin interfaceChunkSink<T>- Specified by:
makeFillFromContextin 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:WritableColumnSourceOur default, inefficient, implementation. Inheritors who care should provide a better implementation.- Specified by:
fillFromChunkin interfaceChunkSink<T>- Specified by:
fillFromChunkin interfaceWritableColumnSource<T>- Parameters:
context- A context containing all mutable/state related data used in writing the Chunk.src- The source of the datarowSequencerowSequence- AnRowSequencerepresenting the keys to be written
-