Package com.illumon.iris.db.v2.sources

Class ByteSparseArraySource

java.lang.Object

com.illumon.iris.db.v2.sources.AbstractColumnSource<T>

com.illumon.iris.db.v2.sources.SparseArrayColumnSource<Byte>

com.illumon.iris.db.v2.sources.ByteSparseArraySource

All Implemented Interfaces:

ChunkSource<Attributes.Values>, ChunkSource.WithPrev<Attributes.Values>, DefaultChunkSource<Attributes.Values>, DefaultChunkSource.WithPrev<Attributes.Values>, FillContextMaker, GetContextMaker, ColumnSource<Byte>, ColumnSourceGetDefaults.ForByte, ElementSource<Byte>, FillUnordered, MutableColumnSource<Byte>, MutableColumnSourceGetDefaults.ForByte, Releasable, WritableChunkSink<Attributes.Values>, WritableSource<Byte>, TupleExporter<Byte>, TupleSource<Byte>, Serializable

public class ByteSparseArraySource
extends SparseArrayColumnSource<Byte>
implements MutableColumnSourceGetDefaults.ForByte

Sparse array source for Byte.

The C-haracterSparseArraySource is replicated to all other types with com.illumon.iris.db.v2.sources.Replicate. (C-haracter is deliberately spelled that way in order to prevent Replicate from altering this very comment).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.illumon.iris.db.v2.sources.SparseArrayColumnSource

SparseArrayColumnSource.FillByContext<UArray>

Nested classes/interfaces inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource

AbstractColumnSource.DefaultedImmutable<DATA_TYPE>, AbstractColumnSource.DefaultedMutable<DATA_TYPE>, AbstractColumnSource.IsSerializable

Nested classes/interfaces inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource

ChunkSource.FillContext, ChunkSource.GetContext, ChunkSource.WithPrev<ATTR extends Attributes.Any>

Nested classes/interfaces inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource

DefaultChunkSource.SupportsContiguousGet<ATTR extends Attributes.Any>, DefaultChunkSource.WithPrev<ATTR extends Attributes.Any>

Nested classes/interfaces inherited from interface com.illumon.iris.db.v2.sources.WritableChunkSink

WritableChunkSink.FillFromContext

Field Summary

Fields

Modifier and Type	Field	Description
protected ByteOneOrN.Block0	blocks
protected ByteOneOrN.Block0	prevBlocks
protected UpdateCommitter<ByteSparseArraySource>	prevFlusher	The presence of a prevFlusher means that this ArraySource wants to track previous values.

Fields inherited from class com.illumon.iris.db.v2.sources.SparseArrayColumnSource

ZERO_LENGTH_SPARSE_ARRAY_COLUMN_SOURCE_ARRAY

Fields inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource

componentType, type

Fields inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource

DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAY

Fields inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource.WithPrev

ZERO_LENGTH_CHUNK_SOURCE_WITH_PREV_ARRAY

Fields inherited from interface com.illumon.iris.db.v2.sources.ColumnSource

ZERO_LENGTH_COLUMN_SOURCE_ARRAY

Fields inherited from interface com.illumon.iris.db.v2.sources.WritableChunkSink

DEFAULT_FILL_FROM_INSTANCE

Fields inherited from interface com.illumon.iris.db.v2.sources.WritableSource

ZERO_LENGTH_WRITABLE_SOURCE_ARRAY

Constructor Summary

Constructors

Constructor	Description
ByteSparseArraySource()

Method Summary

Modifier and Type	Method	Description
void	copy(ColumnSource<Byte> sourceColumn, long sourceKey, long destKey)
void	ensureCapacity(long capacity)
void	fillFromChunkUnordered(WritableChunkSink.FillFromContext context, Chunk<? extends Attributes.Values> src, LongChunk<Attributes.KeyIndices> 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, WritableChunk<? super Attributes.Values> dest, OrderedKeys orderedKeys)	Populates the given destination chunk with data corresponding to the keys from the given OrderedKeys.
Byte	get(long index)	Get the value from the source.
byte	getByte(long index)	Get the value at the index as a byte.
ByteChunk<Attributes.Values>	getChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys)	Returns a chunk of data corresponding to the keys from the given OrderedKeys.
Byte	getPrev(long index)	Get the previous value at the index.
byte	getPrevByte(long index)	Get the previous value at the index as a byte.
ByteChunk<Attributes.Values>	getPrevChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys)	Returns a chunk of previous data corresponding to the keys from the given OrderedKeys.
void	set(long key, byte value)
void	set(long key, Byte value)
void	setNull(long key)
void	shift(ReadOnlyIndex keysToShift, long shiftDelta)
void	startTrackingPrevValues()	ColumnSource implementations that track previous values have the option to not actually start tracking previous values until this method is called.

Methods inherited from class com.illumon.iris.db.v2.sources.SparseArrayColumnSource

fillChunk, fillChunkUnordered, fillFromChunk, fillPrevChunkUnordered, getDateTimeMemoryColumnSource, getPreferredChunkSize, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, getSparseMemoryColumnSource, isImmutable, makeFillFromContext, remove, set, set, set, set, set, set, setImmutable, setNull

Methods inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource

allowsReinterpret, defaultFillChunk, doReinterpret, getComponentType, getGroupingBuilder, getGroupingProvider, getNativeType, getType, hasGrouping, isSerializable, match, reinterpret, setGroupingProvider

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource

fillChunk, getChunkType

Methods inherited from interface com.illumon.iris.db.v2.sources.ColumnSource

allowsReinterpret, cast, createPreviousTuple, createTuple, createTupleFromValues, exportElement, exportElement, exportToExternalKey, getColumnSources, getComponentType, getGroupingBuilder, getGroupingProvider, getNativeType, getPrevSource, getType, hasGrouping, match, reinterpret, releaseCachedResources, setGroupingProvider

Methods inherited from interface com.illumon.iris.db.v2.sources.ColumnSourceGetDefaults.ForByte

getBoolean, getChar, getDouble, getFloat, getInt, getLong, getShort

Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource

getChunk, getChunkByFilling, makeFillContext, makeGetContext

Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource.WithPrev

getPrevChunk, getPrevChunkByFilling

Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.FillContextMaker

makeFillContext

Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.GetContextMaker

makeGetContext

Methods inherited from interface com.illumon.iris.db.v2.sources.MutableColumnSource

isImmutable

Methods inherited from interface com.illumon.iris.db.v2.sources.MutableColumnSourceGetDefaults.ForByte

getPrevBoolean, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, getPrevShort

Methods inherited from interface com.illumon.iris.db.v2.tuples.TupleExporter

exportElementReinterpreted

Methods inherited from interface com.illumon.iris.db.v2.tuples.TupleSource

createTupleFromReinterpretedValues

Field Details

prevFlusher

protected transient UpdateCommitter<ByteSparseArraySource> prevFlusher

The 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.

blocks

protected ByteOneOrN.Block0 blocks

prevBlocks

protected transient ByteOneOrN.Block0 prevBlocks

Constructor Details

ByteSparseArraySource

public ByteSparseArraySource()

Method Details

ensureCapacity

public void ensureCapacity(long capacity)

Specified by:

ensureCapacity in interface WritableSource<Byte>

setNull

public void setNull(long key)

Specified by:

setNull in interface WritableSource<Byte>

set

public final void set(long key, byte value)

Specified by:

set in interface WritableSource<Byte>

Overrides:

set in class SparseArrayColumnSource<Byte>

shift

public void shift(ReadOnlyIndex keysToShift, long shiftDelta)

Overrides:

shift in class SparseArrayColumnSource<Byte>

set

public void set(long key, Byte value)

Specified by:

set in interface WritableSource<Byte>

get

public Byte get(long index)

Description copied from interface: ElementSource

Get the value from the source. This may return boxed values for basic types.

Specified by:

get in interface ColumnSourceGetDefaults.ForByte

Specified by:

get in interface ElementSource<Byte>

Parameters:

index - the location in index space to get the value from.

Returns:

the value at the index, potentially null.

getPrev

public Byte getPrev(long index)

Description copied from interface: ElementSource

Get the previous value at the index. Previous values are used during an LTM update cycle to process changes in data. During normal operation previous values will be identical to current values.

Specified by:

getPrev in interface ElementSource<Byte>

Specified by:

getPrev in interface MutableColumnSourceGetDefaults.ForByte

Parameters:

index - the location in index space to get the value from.

Returns:

the previous value at the index, or null.

copy

public void copy(ColumnSource<Byte> sourceColumn, long sourceKey, long destKey)

Specified by:

copy in interface WritableSource<Byte>

getByte

public final byte getByte(long index)

Description copied from interface: ElementSource

Get the value at the index as a byte.

Specified by:

getByte in interface ElementSource<Byte>

Parameters:

index - the location in index space to get the value from.

Returns:

the boolean at the index, null values are represented by QueryConstants.NULL_BYTE

getPrevByte

public final byte getPrevByte(long index)

Description copied from interface: ElementSource

Get the previous value at the index as a byte. See ElementSource.getPrev(long) for more details.

Specified by:

getPrevByte in interface ElementSource<Byte>

Parameters:

index - the location in index space to get the previous value from.

Returns:

the previous boolean at the index, null values are represented by QueryConstants.NULL_BYTE

startTrackingPrevValues

public void startTrackingPrevValues()

Description copied from interface: ColumnSource

ColumnSource implementations that track previous values have the option to not actually start tracking previous values until this method is called. This is an option, not an obligation: some simple ColumnSource implementations (like TSingleValueSource for various T) always track previous values; other implementations (like PrevColumnSource) never do; some (like TArrayColumnSource) only start tracking once this method is called. An immutable column source can not have distinct prev values; therefore it is implemented as a no-op.

Specified by:

startTrackingPrevValues in interface ColumnSource<Byte>

fillFromChunkUnordered

public void fillFromChunkUnordered(@NotNull WritableChunkSink.FillFromContext context, @NotNull Chunk<? extends Attributes.Values> src, @NotNull LongChunk<Attributes.KeyIndices> keys)

Description copied from interface: WritableChunkSink

Fills the ChunkSink with data from the source, with data corresponding to the keys from the given key chunk.

Specified by:

fillFromChunkUnordered in interface WritableChunkSink<Attributes.Values>

Specified by:

fillFromChunkUnordered in interface WritableSource<Byte>

Parameters:

context - A context containing all mutable/state related data used in writing the Chunk.

src - The source of the data orderedKeys

keys - A LongChunk representing the keys to be written

fillPrevChunk

public void fillPrevChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Attributes.Values> dest, @NotNull OrderedKeys orderedKeys)

Description copied from interface: ChunkSource.WithPrev

Populates the given destination chunk with data corresponding to the keys from the given OrderedKeys.

Specified by:

fillPrevChunk in interface ChunkSource.WithPrev<Attributes.Values>

Overrides:

fillPrevChunk in class AbstractColumnSource<Byte>

Parameters:

context - A context containing all mutable/state related data used in retrieving the Chunk.

dest - The chunk to be populated according to orderedKeys. No assumptions shall be made about the size of the chunk shall be made. The chunk will be populated from position [0,orderedKeys.size()).

orderedKeys - An OrderedKeys representing the keys to be fetched

getChunk

public ByteChunk<Attributes.Values> getChunk(@NotNull ChunkSource.GetContext context, @NotNull OrderedKeys orderedKeys)

Description copied from interface: ChunkSource

Returns a chunk of data corresponding to the keys from the given OrderedKeys.

Specified by:

getChunk in interface ChunkSource<Attributes.Values>

Specified by:

getChunk in interface DefaultChunkSource<Attributes.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 pool

orderedKeys - An OrderedKeys representing the keys to be fetched

Returns:

A chunk of data corresponding to the keys from the given OrderedKeys

getPrevChunk

public ByteChunk<Attributes.Values> getPrevChunk(@NotNull ChunkSource.GetContext context, @NotNull OrderedKeys orderedKeys)

Description copied from interface: ChunkSource.WithPrev

Returns a chunk of previous data corresponding to the keys from the given OrderedKeys.

Specified by:

getPrevChunk in interface ChunkSource.WithPrev<Attributes.Values>

Specified by:

getPrevChunk in interface DefaultChunkSource.WithPrev<Attributes.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 pool

orderedKeys - An OrderedKeys representing the keys to be fetched

Returns:

A chunk of data corresponding to the keys from the given OrderedKeys.