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:
-
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.IsSerializableNested 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.ZonedNested 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
FieldsModifier and TypeFieldDescriptionprotected final LongArraySourceprotected UpdateCommitter<com.illumon.iris.db.v2.sources.ArraySourceHelper<TIME_TYPE,long[]>> The presence of a prevFlusher means that this ArraySource wants to track previous values.Fields inherited from class com.illumon.iris.db.v2.sources.ArrayBackedColumnSource
BLOCK_SIZEFields inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource
componentType, typeFields inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource
DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAYFields inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource.WithPrev
ZERO_LENGTH_CHUNK_SOURCE_WITH_PREV_ARRAYFields inherited from interface com.illumon.iris.db.v2.sources.ColumnSource
ZERO_LENGTH_COLUMN_SOURCE_ARRAYFields inherited from interface com.illumon.iris.db.v2.sources.WritableChunkSink
DEFAULT_FILL_FROM_INSTANCEFields inherited from interface com.illumon.iris.db.v2.sources.WritableSource
ZERO_LENGTH_WRITABLE_SOURCE_ARRAY -
Constructor Summary
ConstructorsConstructorDescriptionNanosBasedTimeArraySource(Class<TIME_TYPE> type, LongArraySource nanoSource) -
Method Summary
Modifier and TypeMethodDescription<ALTERNATE_DATA_TYPE>
booleanallowsReinterpret(Class<ALTERNATE_DATA_TYPE> alternateDataType) Test if a reinterpret call will succeed.voidcopy(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.voidensureCapacity(long capacity) voidensureCapacity(long size, boolean nullFill) voidfillChunk(ChunkSource.FillContext context, WritableChunk<? super Attributes.Values> destination, OrderedKeys orderedKeys) Populates the given destination chunk with data corresponding to the keys from the givenOrderedKeys.voidfillFromChunk(WritableChunkSink.FillFromContext context, Chunk<? extends Attributes.Values> src, OrderedKeys orderedKeys) Our default, inefficient, implementation.voidfillFromChunkUnordered(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.voidfillPrevChunk(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 voidfillSparseChunk(WritableChunk<? super Attributes.Values> destGeneric, OrderedKeys indices) protected voidfillSparseChunkUnordered(WritableChunk<? super Attributes.Values> destGeneric, LongChunk<? extends Attributes.KeyIndices> indices) protected voidfillSparsePrevChunk(WritableChunk<? super Attributes.Values> destGeneric, OrderedKeys indices) protected voidfillSparsePrevChunkUnordered(WritableChunk<? super Attributes.Values> destGeneric, LongChunk<? extends Attributes.KeyIndices> indices) get(long index) Get the value from the source.final longgetAndSetUnsafe(long index, long newValue) final longGet the capacity of this column source.getChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys) Returns a chunk of data corresponding to the keys from the givenOrderedKeys.longgetLong(long index) Get the value at the index as a long.getPrev(long index) Get the previous value at the index.getPrevChunk(ChunkSource.GetContext context, OrderedKeys orderedKeys) Returns a chunk of previous data corresponding to the keys from the givenOrderedKeys.longgetPrevLong(long index) Get the previous value at the index as a long.final longgetUnsafe(long index) makeFillContext(int chunkCapacity, SharedContext sharedContext) Allocate a newChunkSource.FillContextfor filling chunks from thisFillContextMaker, typically aChunkSource.makeFillFromContext(int chunkCapacity) Provide a default, emptyWritableChunkSink.FillFromContextfor 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_TYPEmakeValue(long nanos) longresetWritableChunkToBackingStore(ResettableWritableChunk chunk, long position) Resets the given chunk to provide a write-through reference to our backing array.voidset(long key, long value) voidvoidsetNull(long key) voidshift(long start, long end, long offset) voidForce my inheritors to implement this method, rather than taking the interface default.booleanCheck if this class supports time conversion.Convert this source to aDBDateTimesource.Convert this source to alongsource of nanoseconds of epoch.Convert this source to anInstantsource.toLocalDate(ZoneId zone) toLocalTime(ZoneId zone) protected abstract longtoZonedDateTime(ZoneId zone) Convert this source to aZonedDateTimesource 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, setMethods inherited from class com.illumon.iris.db.v2.sources.AbstractColumnSource
canUseGrouping, defaultFillChunk, getComponentType, getGroupingBuilder, getGroupingProvider, getNativeType, getType, hasGrouping, hasGrouping, isSerializable, match, matchWithGrouping, reinterpret, setGroupingProviderMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource
getChunkTypeMethods 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, hasGrouping, isImmutable, match, reinterpret, releaseCachedResources, setGroupingProviderMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource
getChunk, getChunkByFilling, makeGetContextMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource.WithPrev
getPrevChunk, getPrevChunkByFillingMethods inherited from interface com.illumon.iris.db.v2.sources.ElementSource
getBoolean, getByte, getChar, getDouble, getFloat, getInt, getPrevBoolean, getPrevByte, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevShort, getShortMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.FillContextMaker
makeFillContextMethods inherited from interface com.illumon.iris.db.v2.sources.FillUnordered
fillChunkUnordered, fillPrevChunkUnorderedMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.GetContextMaker
makeGetContextMethods inherited from interface com.illumon.iris.db.v2.tuples.TupleExporter
exportElementReinterpretedMethods inherited from interface com.illumon.iris.db.v2.tuples.TupleSource
createTupleFromReinterpretedValuesMethods 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<TIME_TYPE,long[]>> 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:
setin interfaceWritableSource<TIME_TYPE>
-
set
public void set(long key, long value) - Specified by:
setin interfaceWritableSource<TIME_TYPE>- Overrides:
setin classArrayBackedColumnSource<TIME_TYPE>
-
setNull
public void setNull(long key) - Specified by:
setNullin interfaceWritableSource<TIME_TYPE>
-
getLong
public long getLong(long index) Description copied from interface:ElementSourceGet the value at the index as a long.- Specified by:
getLongin 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:ElementSourceGet the previous value at the index as a long. SeeElementSource.getPrev(long)for more details.- Specified by:
getPrevLongin 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:ElementSourceGet the value from the source. This may return boxed values for basic types.- Specified by:
getin 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:ElementSourceGet the previous value at the index. Previous values are used during anLTMupdatecycle to process changes in data. Duringnormaloperation previous values will be identical tocurrentvalues.- Specified by:
getPrevin 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:
copyin interfaceWritableSource<TIME_TYPE>
-
shift
public void shift(long start, long end, long offset) - Specified by:
shiftin interfaceShiftData.ShiftCallback- Overrides:
shiftin classArrayBackedColumnSource<TIME_TYPE>
-
ensureCapacity
public void ensureCapacity(long capacity) - Specified by:
ensureCapacityin interfaceWritableSource<TIME_TYPE>
-
ensureCapacity
public void ensureCapacity(long size, boolean nullFill) - Specified by:
ensureCapacityin classArrayBackedColumnSource<TIME_TYPE>
-
startTrackingPrevValues
public void startTrackingPrevValues()Force my inheritors to implement this method, rather than taking the interface default.- Specified by:
startTrackingPrevValuesin interfaceColumnSource<TIME_TYPE>
-
resetWritableChunkToBackingStore
Description copied from class:ArrayBackedColumnSourceResets 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 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:ChunkSourcePopulates the given destination chunk with data corresponding to the keys from the givenOrderedKeys.- Specified by:
fillChunkin interfaceChunkSource<TIME_TYPE>- Overrides:
fillChunkin 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- AnOrderedKeysrepresenting 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.WithPrevPopulates the given destination chunk with data corresponding to the keys from the givenOrderedKeys.- Specified by:
fillPrevChunkin 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- AnOrderedKeysrepresenting the keys to be fetched
-
getChunk
public Chunk<Attributes.Values> getChunk(@NotNull ChunkSource.GetContext context, @NotNull OrderedKeys orderedKeys) Description copied from interface:ChunkSourceReturns a chunk of data corresponding to the keys from the givenOrderedKeys.- Specified by:
getChunkin interfaceChunkSource<TIME_TYPE>- Specified by:
getChunkin interfaceDefaultChunkSource<TIME_TYPE>- Overrides:
getChunkin 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- AnOrderedKeysrepresenting 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.WithPrevReturns a chunk of previous data corresponding to the keys from the givenOrderedKeys.- Specified by:
getPrevChunkin interfaceChunkSource.WithPrev<TIME_TYPE>- Specified by:
getPrevChunkin 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- AnOrderedKeysrepresenting 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:
fillSparseChunkin classArrayBackedColumnSource<TIME_TYPE>
-
fillSparsePrevChunk
protected void fillSparsePrevChunk(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull OrderedKeys indices) - Specified by:
fillSparsePrevChunkin classArrayBackedColumnSource<TIME_TYPE>
-
fillSparseChunkUnordered
protected void fillSparseChunkUnordered(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull LongChunk<? extends Attributes.KeyIndices> indices) - Specified by:
fillSparseChunkUnorderedin classArrayBackedColumnSource<TIME_TYPE>
-
fillSparsePrevChunkUnordered
protected void fillSparsePrevChunkUnordered(@NotNull WritableChunk<? super Attributes.Values> destGeneric, @NotNull LongChunk<? extends Attributes.KeyIndices> indices) - Specified by:
fillSparsePrevChunkUnorderedin 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:WritableChunkSinkFills the ChunkSink with data from the source, with data corresponding to the keys from the given key chunk.- Specified by:
fillFromChunkUnorderedin interfaceWritableChunkSink<TIME_TYPE>- Specified by:
fillFromChunkUnorderedin interfaceWritableSource<TIME_TYPE>- Parameters:
context- A context containing all mutable/state related data used in writing the Chunk.src- The source of the dataorderedKeyskeys- ALongChunkrepresenting the keys to be written
-
allowsReinterpret
public <ALTERNATE_DATA_TYPE> boolean allowsReinterpret(@NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType) Description copied from interface:ColumnSourceTest if a reinterpret call will succeed.- Specified by:
allowsReinterpretin interfaceColumnSource<TIME_TYPE>- Overrides:
allowsReinterpretin 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:AbstractColumnSourceSupply allowed reinterpret results. The default implementation handles the most common case to avoid code duplication.- Overrides:
doReinterpretin 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:ConvertableTimeSourceCheck if this class supports time conversion. If false, all other methods will fail.- Specified by:
supportsTimeConversionin interfaceConvertableTimeSource- Returns:
- true if time conversion is supported.
-
toZonedDateTime
Description copied from interface:ConvertableTimeSourceConvert this source to aZonedDateTimesource at the specifiedzone.- Specified by:
toZonedDateTimein interfaceConvertableTimeSource- Parameters:
zone- the time zone- Returns:
- a view of this source as a
ZonedDateTime
-
toLocalDate
Description copied from interface:ConvertableTimeSource- Specified by:
toLocalDatein interfaceConvertableTimeSource- Parameters:
zone- the time zone- Returns:
- a view of this source as a
LocalDate
-
toLocalTime
Description copied from interface:ConvertableTimeSource- Specified by:
toLocalTimein interfaceConvertableTimeSource- Parameters:
zone- the time zone- Returns:
- a view of this source as a
LocalTime
-
toDBDateTime
Description copied from interface:ConvertableTimeSourceConvert this source to aDBDateTimesource.- Specified by:
toDBDateTimein interfaceConvertableTimeSource- Returns:
- a view of this source as a
DBDateTime
-
toInstant
Description copied from interface:ConvertableTimeSourceConvert this source to anInstantsource.- Specified by:
toInstantin interfaceConvertableTimeSource- Returns:
- a view of this source as a
Instant
-
toEpochNano
Description copied from interface:ConvertableTimeSourceConvert this source to alongsource of nanoseconds of epoch.- Specified by:
toEpochNanoin 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:WritableSourceProvide a default, emptyWritableChunkSink.FillFromContextfor 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:WritableSourceOur 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 dataorderedKeysorderedKeys- AnOrderedKeysrepresenting the keys to be written
-