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

Class DeltaAwareColumnSource<T>

java.lang.Object
com.illumon.iris.db.v2.sources.AbstractColumnSource<T>
com.illumon.iris.db.v2.sources.deltaaware.DeltaAwareColumnSource<T>
All Implemented Interfaces:
ChunkSource<Attributes.Values>, ChunkSource.WithPrev<Attributes.Values>, DefaultChunkSource<Attributes.Values>, DefaultChunkSource.WithPrev<Attributes.Values>, FillContextMaker, GetContextMaker, ColumnSource<T>, ElementSource<T>, Releasable, WritableChunkSink<Attributes.Values>, WritableSource<T>, TupleExporter<T>, TupleSource<T>, Serializable
public final class DeltaAwareColumnSource<T> extends AbstractColumnSource<T> implements WritableSource<T>, WritableChunkSink<Attributes.Values>
See Also:

  • Constructor Details

    • DeltaAwareColumnSource

      public DeltaAwareColumnSource(Class<T> type)

  • Method Details

    • makeGetContext

      public ChunkSource.GetContext makeGetContext(int chunkSize, SharedContext sharedContext)
      Description copied from interface: GetContextMaker
      Allocate a new ChunkSource.GetContext for retrieving chunks from this GetContextMaker, typically a ChunkSource.
      Specified by:
      makeGetContext in interface DefaultChunkSource<T>
      Specified by:
      makeGetContext in interface GetContextMaker
      Parameters:
      chunkSize - The maximum size required for any WritableChunk allocated as part of the result.
      sharedContext - Shared store of intermediate results.
      Returns:
      A context for use with get operations

    • makeFillContext

      public ChunkSource.FillContext makeFillContext(int chunkSize, SharedContext sharedContext)
      Description copied from interface: FillContextMaker
      Allocate a new ChunkSource.FillContext for filling chunks from this FillContextMaker, typically a ChunkSource.
      Specified by:
      makeFillContext in interface DefaultChunkSource<T>
      Specified by:
      makeFillContext in interface FillContextMaker
      Parameters:
      chunkSize - The maximum size of any WritableChunk that will be filled with this context
      sharedContext - Shared store of intermediate results.
      Returns:
      A context for use with fill operations

    • getChunk

      public Chunk<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<T>
      Specified by:
      getChunk in interface DefaultChunkSource<T>
      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

    • fillChunk

      public void fillChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Attributes.Values> dest, @NotNull OrderedKeys orderedKeys)
      Description copied from interface: ChunkSource
      Populates the given destination chunk with data corresponding to the keys from the given OrderedKeys.
      Specified by:
      fillChunk in interface ChunkSource<T>
      Overrides:
      fillChunk in class AbstractColumnSource<T>
      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

    • getPrevChunk

      public Chunk<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<T>
      Specified by:
      getPrevChunk in interface DefaultChunkSource.WithPrev<T>
      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.

    • 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<T>
      Overrides:
      fillPrevChunk in class AbstractColumnSource<T>
      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

    • fillFromChunk

      public void fillFromChunk(@NotNull WritableChunkSink.FillFromContext context, @NotNull Chunk<? extends Attributes.Values> src, @NotNull OrderedKeys orderedKeys)
      Description copied from interface: WritableSource
      Our default, inefficient, implementation. Inheritors who care should provide a better implementation.
      Specified by:
      fillFromChunk in interface WritableChunkSink<T>
      Specified by:
      fillFromChunk in interface WritableSource<T>
      Parameters:
      context - A context containing all mutable/state related data used in writing the Chunk.
      src - The source of the data orderedKeys
      orderedKeys - An OrderedKeys representing the keys to be written

    • 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<T>
      Specified by:
      fillFromChunkUnordered in interface WritableSource<T>
      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

    • get

      public T 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 ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the value at the index, potentially null.

    • getBoolean

      public Boolean getBoolean(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a Boolean.
      Specified by:
      getBoolean in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the boolean at the index, potentially null.

    • getByte

      public byte getByte(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a byte.
      Specified by:
      getByte in interface ElementSource<T>
      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

    • getChar

      public char getChar(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a char.
      Specified by:
      getChar in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the char at the index, null values are represented by QueryConstants.NULL_CHAR

    • getDouble

      public double getDouble(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a double.
      Specified by:
      getDouble in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the double at the index, null values are represented by QueryConstants.NULL_DOUBLE

    • getFloat

      public float getFloat(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a float.
      Specified by:
      getFloat in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the float at the index, null values are represented by QueryConstants.NULL_FLOAT

    • getInt

      public int getInt(long index)
      Description copied from interface: ElementSource
      Get the value at the index as an int.
      Specified by:
      getInt in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the int at the index, null values are represented by QueryConstants.NULL_INT

    • getLong

      public long getLong(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a long.
      Specified by:
      getLong in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the long at the index, null values are represented by QueryConstants.NULL_LONG

    • getShort

      public short getShort(long index)
      Description copied from interface: ElementSource
      Get the value at the index as a short.
      Specified by:
      getShort in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the short at the index, null values are represented by QueryConstants.NULL_SHORT

    • getPrev

      public T 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<T>
      Parameters:
      index - the location in index space to get the value from.
      Returns:
      the previous value at the index, or null.

    • getPrevBoolean

      public Boolean getPrevBoolean(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a Boolean. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevBoolean in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous boolean at the index, or null.

    • getPrevByte

      public 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<T>
      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

    • getPrevChar

      public char getPrevChar(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a char. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevChar in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous char at the index, null values are represented by QueryConstants.NULL_CHAR

    • getPrevDouble

      public double getPrevDouble(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a double. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevDouble in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous double at the index, null values are represented by QueryConstants.NULL_DOUBLE

    • getPrevFloat

      public float getPrevFloat(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a float. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevFloat in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous float at the index, null values are represented by QueryConstants.NULL_FLOAT

    • getPrevInt

      public int getPrevInt(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as an int. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevInt in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous int at the index, null values are represented by QueryConstants.NULL_INT

    • getPrevLong

      public long getPrevLong(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a long. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevLong in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous long at the index, null values are represented by QueryConstants.NULL_LONG

    • getPrevShort

      public short getPrevShort(long index)
      Description copied from interface: ElementSource
      Get the previous value at the index as a short. See ElementSource.getPrev(long) for more details.
      Specified by:
      getPrevShort in interface ElementSource<T>
      Parameters:
      index - the location in index space to get the previous value from.
      Returns:
      the previous short at the index, null values are represented by QueryConstants.NULL_SHORT

    • set

      public void set(long key, T value)
      Specified by:
      set in interface WritableSource<T>

    • setNull

      public void setNull(long key)
      Specified by:
      setNull in interface WritableSource<T>

    • set

      public void set(long key, byte value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, char value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, double value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, float value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, int value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, long value)
      Specified by:
      set in interface WritableSource<T>

    • set

      public void set(long key, short value)
      Specified by:
      set in interface WritableSource<T>

    • 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<T>

    • copy

      public void copy(ColumnSource<T> sourceColumn, long sourceKey, long destKey)
      Specified by:
      copy in interface WritableSource<T>

    • ensureCapacity

      public void ensureCapacity(long capacity)
      Specified by:
      ensureCapacity in interface WritableSource<T>

    • isImmutable

      public boolean isImmutable()
      Description copied from interface: ColumnSource
      Determine if this column source is immutable, meaning that the values at a given index key never change.
      Specified by:
      isImmutable in interface ColumnSource<T>
      Returns:
      true if the values at a given index of the column source never change, false otherwise