Package com.illumon.iris.db.v2.sources
Class NanosBasedTimeArraySource<TIME_TYPE>
java.lang.Object
com.illumon.iris.db.v2.sources.AbstractColumnSource<T>
com.illumon.iris.db.v2.sources.ArrayBackedColumnSource<T>
com.illumon.iris.db.v2.sources.NanosBasedTimeArraySource<TIME_TYPE>
- All Implemented Interfaces:
ChunkSource<Attributes.Values>
,ChunkSource.WithPrev<Attributes.Values>
,DefaultChunkSource<Attributes.Values>
,DefaultChunkSource.WithPrev<Attributes.Values>
,FillContextMaker
,GetContextMaker
,ColumnSource<TIME_TYPE>
,ConvertableTimeSource
,ElementSource<TIME_TYPE>
,FillUnordered
,Releasable
,WritableChunkSink<Attributes.Values>
,WritableSource<TIME_TYPE>
,TupleExporter<TIME_TYPE>
,TupleSource<TIME_TYPE>
,ShiftData.ShiftCallback
,Serializable
- Direct Known Subclasses:
DateTimeArraySource
,InstantArraySource
,ZonedDateTimeArraySource
public abstract class NanosBasedTimeArraySource<TIME_TYPE> extends ArrayBackedColumnSource<T> implements WritableSource<TIME_TYPE>, FillUnordered, ConvertableTimeSource
- See Also:
- Serialized Form
-
Nested Class Summary
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.ConvertableTimeSource
ConvertableTimeSource.Zoned
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 LongArraySource
nanoSource
protected UpdateCommitter<com.illumon.iris.db.v2.sources.ArraySourceHelper<T,UArray>>
prevFlusher
The presence of a prevFlusher means that this ArraySource wants to track previous values.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 NanosBasedTimeArraySource(Class<TIME_TYPE> type)
NanosBasedTimeArraySource(Class<TIME_TYPE> type, LongArraySource nanoSource)
-
Method Summary
Modifier and Type Method Description <ALTERNATE_DATA_TYPE>
booleanallowsReinterpret(Class<ALTERNATE_DATA_TYPE> alternateDataType)
Test if a reinterpret call will succeed.void
copy(ColumnSource<TIME_TYPE> sourceColumn, long sourceKey, long destKey)
protected <ALTERNATE_DATA_TYPE>
ColumnSource<ALTERNATE_DATA_TYPE>doReinterpret(Class<ALTERNATE_DATA_TYPE> alternateDataType)
Supply allowed reinterpret results.void
ensureCapacity(long capacity)
void
ensureCapacity(long size, boolean nullFill)
void
fillChunk(ChunkSource.FillContext context, WritableChunk<? super Attributes.Values> destination, OrderedKeys orderedKeys)
Populates the given destination chunk with data corresponding to the keys from the givenOrderedKeys
.void
fillFromChunk(WritableChunkSink.FillFromContext context, Chunk<? extends Attributes.Values> src, OrderedKeys orderedKeys)
Our default, inefficient, implementation.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> destination, OrderedKeys orderedKeys)
Populates the given destination chunk with data corresponding to the keys from the givenOrderedKeys
.protected void
fillSparseChunk(WritableChunk<? super Attributes.Values> destGeneric, OrderedKeys indices)
protected void
fillSparseChunkUnordered(WritableChunk<? super Attributes.Values> destGeneric, LongChunk<? extends Attributes.KeyIndices> indices)
protected void
fillSparsePrevChunk(WritableChunk<? super Attributes.Values> destGeneric, OrderedKeys indices)
protected void
fillSparsePrevChunkUnordered(WritableChunk<? super Attributes.Values> destGeneric, LongChunk<? extends Attributes.KeyIndices> indices)
TIME_TYPE
get(long index)
Get the value from the source.long
getAndSetUnsafe(long index, long newValue)
long
getCapacity()
Get the capacity of this column source.Chunk<Attributes.Values>
getChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys)
Returns a chunk of data corresponding to the keys from the givenOrderedKeys
.long
getLong(long index)
Get the value at the index as a long.TIME_TYPE
getPrev(long index)
Get the previous value at the index.Chunk<Attributes.Values>
getPrevChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys)
Returns a chunk of previous data corresponding to the keys from the givenOrderedKeys
.long
getPrevLong(long index)
Get the previous value at the index as a long.long
getUnsafe(long index)
ChunkSource.FillContext
makeFillContext(int chunkCapacity, SharedContext sharedContext)
Allocate a newChunkSource.FillContext
for filling chunks from thisFillContextMaker
, typically aChunkSource
.WritableChunkSink.FillFromContext
makeFillFromContext(int chunkCapacity)
Provide a default, emptyWritableChunkSink.FillFromContext
for use with our defaultWritableSource.fillFromChunk(com.illumon.iris.db.v2.sources.WritableChunkSink.FillFromContext, com.illumon.iris.db.v2.sources.chunk.Chunk<? extends com.illumon.iris.db.v2.sources.chunk.Attributes.Values>, com.illumon.iris.db.v2.utils.OrderedKeys)
.protected abstract TIME_TYPE
makeValue(long nanos)
long
resetWritableChunkToBackingStore(ResettableWritableChunk chunk, long position)
Resets the given chunk to provide a write-through reference to our backing array.void
set(long key, long value)
void
set(long key, TIME_TYPE value)
void
setNull(long key)
void
shift(long start, long end, long offset)
void
startTrackingPrevValues()
Force my inheritors to implement this method, rather than taking the interface default.boolean
supportsTimeConversion()
Check if this class supports time conversion.ColumnSource<DBDateTime>
toDBDateTime()
Convert this source to aDBDateTime
source.LongArraySource
toEpochNano()
Convert this source to along
source of nanoseconds of epoch.ColumnSource<Instant>
toInstant()
Convert this source to anInstant
source.ColumnSource<LocalDate>
toLocalDate(ZoneId zone)
ColumnSource<LocalTime>
toLocalTime(ZoneId zone)
protected abstract long
toNanos(TIME_TYPE value)
ColumnSource<ZonedDateTime>
toZonedDateTime(ZoneId zone)
Convert this source to aZonedDateTime
source at the specifiedzone
.Methods inherited from class com.illumon.iris.db.v2.sources.ArrayBackedColumnSource
fillChunkUnordered, fillPrevChunkUnordered, getDateTimeMemoryColumnSource, getDateTimeMemoryColumnSource, getImmutableMemoryColumnSource, getImmutableMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, getMemoryColumnSource, isImmutable, set, set, set, set, set, set
Methods inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource
defaultFillChunk, 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.ColumnSource
cast, createPreviousTuple, createTuple, createTupleFromValues, exportElement, exportElement, exportToExternalKey, getColumnSources, getComponentType, getGroupingBuilder, getGroupingProvider, getNativeType, getPrevSource, getType, hasGrouping, isImmutable, match, reinterpret, releaseCachedResources, setGroupingProvider
Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource
getChunk, getChunkByFilling, 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.ElementSource
getBoolean, getByte, getChar, getDouble, getFloat, getInt, getPrevBoolean, getPrevByte, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevShort, getShort
Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.FillContextMaker
makeFillContext
Methods inherited from interface com.illumon.iris.db.v2.sources.FillUnordered
fillChunkUnordered, fillPrevChunkUnordered
Methods inherited from interface com.illumon.iris.db.v2.sources.chunk.GetContextMaker
makeGetContext
Methods inherited from interface com.illumon.iris.db.v2.tuples.TupleExporter
exportElementReinterpreted
Methods inherited from interface com.illumon.iris.db.v2.tuples.TupleSource
createTupleFromReinterpretedValues
Methods inherited from interface com.illumon.iris.db.v2.sources.WritableSource
fillFromChunk, makeFillFromContext, set, set, set, set, set, set, setNull
-
Field Details
-
nanoSource
-
prevFlusher
protected transient UpdateCommitter<com.illumon.iris.db.v2.sources.ArraySourceHelper<T,UArray>> 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.
-
-
Constructor Details
-
NanosBasedTimeArraySource
-
NanosBasedTimeArraySource
public NanosBasedTimeArraySource(@NotNull Class<TIME_TYPE> type, @NotNull LongArraySource nanoSource)
-
-
Method Details
-
makeValue
-
toNanos
-
set
- Specified by:
set
in interfaceWritableSource<TIME_TYPE>
-
set
public void set(long key, long value)- Specified by:
set
in interfaceWritableSource<TIME_TYPE>
- Overrides:
set
in classArrayBackedColumnSource<TIME_TYPE>
-
setNull
public void setNull(long key)- Specified by:
setNull
in interfaceWritableSource<TIME_TYPE>
-
getLong
public long getLong(long index)Description copied from interface:ElementSource
Get the value at the index as a long.- Specified by:
getLong
in interfaceElementSource<TIME_TYPE>
- 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
-
getPrevLong
public long getPrevLong(long index)Description copied from interface:ElementSource
Get the previous value at the index as a long. SeeElementSource.getPrev(long)
for more details.- Specified by:
getPrevLong
in interfaceElementSource<TIME_TYPE>
- 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
-
getUnsafe
public final long getUnsafe(long index) -
getAndSetUnsafe
public final long getAndSetUnsafe(long index, long newValue) -
get
Description copied from interface:ElementSource
Get the value from the source. This may return boxed values for basic types.- Specified by:
get
in interfaceElementSource<TIME_TYPE>
- Parameters:
index
- the location in index space to get the value from.- Returns:
- the value at the index, potentially null.
-
getPrev
Description copied from interface:ElementSource
Get the previous value at the index. Previous values are used during anLTM
update
cycle to process changes in data. Duringnormal
operation previous values will be identical tocurrent
values.- Specified by:
getPrev
in interfaceElementSource<TIME_TYPE>
- Parameters:
index
- the location in index space to get the value from.- Returns:
- the previous value at the index, or null.
-
copy
- Specified by:
copy
in interfaceWritableSource<TIME_TYPE>
-
shift
public void shift(long start, long end, long offset)- Specified by:
shift
in interfaceShiftData.ShiftCallback
- Overrides:
shift
in classArrayBackedColumnSource<TIME_TYPE>
-
ensureCapacity
public void ensureCapacity(long capacity)- Specified by:
ensureCapacity
in interfaceWritableSource<TIME_TYPE>
-
ensureCapacity
public void ensureCapacity(long size, boolean nullFill)- Specified by:
ensureCapacity
in classArrayBackedColumnSource<TIME_TYPE>
-
startTrackingPrevValues
public void startTrackingPrevValues()Force my inheritors to implement this method, rather than taking the interface default.- Specified by:
startTrackingPrevValues
in interfaceColumnSource<TIME_TYPE>
-
makeFillContext
Description copied from interface:FillContextMaker
Allocate a newChunkSource.FillContext
for filling chunks from thisFillContextMaker
, typically aChunkSource
.- Specified by:
makeFillContext
in interfaceDefaultChunkSource<TIME_TYPE>
- Specified by:
makeFillContext
in interfaceFillContextMaker
- Parameters:
chunkCapacity
- The maximum size of anyWritableChunk
that will be filled with this contextsharedContext
- Shared store of intermediate results.- Returns:
- A context for use with fill operations
-
resetWritableChunkToBackingStore
public long resetWritableChunkToBackingStore(@NotNull ResettableWritableChunk chunk, long position)Description copied from class:ArrayBackedColumnSource
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 classArrayBackedColumnSource<TIME_TYPE>
- Parameters:
chunk
- the writable chunk to reset to our backing array.position
- position that we require- Returns:
- the first position addressable by the chunk
-
fillChunk
public void fillChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Attributes.Values> destination, @NotNull OrderedKeys orderedKeys)Description copied from interface:ChunkSource
Populates the given destination chunk with data corresponding to the keys from the givenOrderedKeys
.- Specified by:
fillChunk
in interfaceChunkSource<TIME_TYPE>
- Overrides:
fillChunk
in classArrayBackedColumnSource<TIME_TYPE>
- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk.destination
- The chunk to be populated according toorderedKeys
. 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
- AnOrderedKeys
representing the keys to be fetched
-
fillPrevChunk
public void fillPrevChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Attributes.Values> destination, @NotNull OrderedKeys orderedKeys)Description copied from interface:ChunkSource.WithPrev
Populates the given destination chunk with data corresponding to the keys from the givenOrderedKeys
.- Specified by:
fillPrevChunk
in interfaceChunkSource.WithPrev<TIME_TYPE>
- Parameters:
context
- A context containing all mutable/state related data used in retrieving the Chunk.destination
- The chunk to be populated according toorderedKeys
. 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
- AnOrderedKeys
representing the keys to be fetched
-
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 givenOrderedKeys
.- Specified by:
getChunk
in interfaceChunkSource<TIME_TYPE>
- Specified by:
getChunk
in interfaceDefaultChunkSource<TIME_TYPE>
- Overrides:
getChunk
in classArrayBackedColumnSource<TIME_TYPE>
- 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 poolorderedKeys
- AnOrderedKeys
representing the keys to be fetched- Returns:
- A chunk of data corresponding to the keys from the given
OrderedKeys
-
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 givenOrderedKeys
.- Specified by:
getPrevChunk
in interfaceChunkSource.WithPrev<TIME_TYPE>
- Specified by:
getPrevChunk
in interfaceDefaultChunkSource.WithPrev<TIME_TYPE>
- 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 poolorderedKeys
- AnOrderedKeys
representing the keys to be fetched- Returns:
- A chunk of data corresponding to the keys from the given
OrderedKeys
.
-
fillSparseChunk
protected void fillSparseChunk(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull OrderedKeys indices)- Specified by:
fillSparseChunk
in classArrayBackedColumnSource<TIME_TYPE>
-
fillSparsePrevChunk
protected void fillSparsePrevChunk(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull OrderedKeys indices)- Specified by:
fillSparsePrevChunk
in classArrayBackedColumnSource<TIME_TYPE>
-
fillSparseChunkUnordered
protected void fillSparseChunkUnordered(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull LongChunk<? extends Attributes.KeyIndices> indices)- Specified by:
fillSparseChunkUnordered
in classArrayBackedColumnSource<TIME_TYPE>
-
fillSparsePrevChunkUnordered
protected void fillSparsePrevChunkUnordered(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull LongChunk<? extends Attributes.KeyIndices> indices)- Specified by:
fillSparsePrevChunkUnordered
in classArrayBackedColumnSource<TIME_TYPE>
-
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 interfaceWritableChunkSink<TIME_TYPE>
- Specified by:
fillFromChunkUnordered
in interfaceWritableSource<TIME_TYPE>
- Parameters:
context
- A context containing all mutable/state related data used in writing the Chunk.src
- The source of the dataorderedKeys
keys
- ALongChunk
representing the keys to be written
-
allowsReinterpret
public <ALTERNATE_DATA_TYPE> boolean allowsReinterpret(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType)Description copied from interface:ColumnSource
Test if a reinterpret call will succeed.- Specified by:
allowsReinterpret
in interfaceColumnSource<TIME_TYPE>
- Overrides:
allowsReinterpret
in classAbstractColumnSource<TIME_TYPE>
- Type Parameters:
ALTERNATE_DATA_TYPE
- the dataType to inquire about- 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 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<TIME_TYPE>
- Type Parameters:
ALTERNATE_DATA_TYPE
- the dataType to reinterpret to- Parameters:
alternateDataType
- The alternate data type- Returns:
- The resulting
ColumnSource
-
supportsTimeConversion
public boolean supportsTimeConversion()Description copied from interface:ConvertableTimeSource
Check if this class supports time conversion. If false, all other methods will fail.- Specified by:
supportsTimeConversion
in interfaceConvertableTimeSource
- Returns:
- true if time conversion is supported.
-
toZonedDateTime
Description copied from interface:ConvertableTimeSource
Convert this source to aZonedDateTime
source at the specifiedzone
.- Specified by:
toZonedDateTime
in interfaceConvertableTimeSource
- Parameters:
zone
- the time zone- Returns:
- a view of this source as a
ZonedDateTime
-
toLocalDate
Description copied from interface:ConvertableTimeSource
- Specified by:
toLocalDate
in interfaceConvertableTimeSource
- Parameters:
zone
- the time zone- Returns:
- a view of this source as a
LocalDate
-
toLocalTime
Description copied from interface:ConvertableTimeSource
- Specified by:
toLocalTime
in interfaceConvertableTimeSource
- Parameters:
zone
- the time zone- Returns:
- a view of this source as a
LocalTime
-
toDBDateTime
Description copied from interface:ConvertableTimeSource
Convert this source to aDBDateTime
source.- Specified by:
toDBDateTime
in interfaceConvertableTimeSource
- Returns:
- a view of this source as a
DBDateTime
-
toInstant
Description copied from interface:ConvertableTimeSource
Convert this source to anInstant
source.- Specified by:
toInstant
in interfaceConvertableTimeSource
- Returns:
- a view of this source as a
Instant
-
toEpochNano
Description copied from interface:ConvertableTimeSource
Convert this source to along
source of nanoseconds of epoch.- Specified by:
toEpochNano
in interfaceConvertableTimeSource
- Returns:
- a view of this source as a
ZonedDateTime
-
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:WritableSource
Provide a default, emptyWritableChunkSink.FillFromContext
for use with our defaultWritableSource.fillFromChunk(com.illumon.iris.db.v2.sources.WritableChunkSink.FillFromContext, com.illumon.iris.db.v2.sources.chunk.Chunk<? extends com.illumon.iris.db.v2.sources.chunk.Attributes.Values>, com.illumon.iris.db.v2.utils.OrderedKeys)
. -
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.- Parameters:
context
- A context containing all mutable/state related data used in writing the Chunk.src
- The source of the dataorderedKeys
orderedKeys
- AnOrderedKeys
representing the keys to be written
-