Package io.deephaven.engine.table.impl.sources.immutable

Class ImmutableConstantLongSource

java.lang.Object

io.deephaven.engine.table.impl.AbstractColumnSource<Long>

io.deephaven.engine.table.impl.sources.immutable.ImmutableConstantLongSource

All Implemented Interfaces:

ChunkSource<Values>, ChunkSource.WithPrev<Values>, ColumnSource<Long>, ElementSource<Long>, FillContextMaker, GetContextMaker, ColumnSourceGetDefaults.ForLong, ColumnSourceGetDefaults.LongBacked<Long>, DefaultChunkSource<Values>, DefaultChunkSource.WithPrev<Values>, ImmutableColumnSource<Long>, ImmutableColumnSourceGetDefaults.ForLong, PushdownFilterMatcher, ConvertibleTimeSource, FillUnordered<Values>, InMemoryColumnSource, RowKeyAgnosticChunkSource<Values>, Releasable, TupleExporter<Long>, TupleSource<Long>

public class ImmutableConstantLongSource
extends AbstractColumnSource<Long>
implements ImmutableColumnSourceGetDefaults.ForLong, InMemoryColumnSource, RowKeyAgnosticChunkSource<Values>, ConvertibleTimeSource

Constant-value immutable ColumnSource of long.

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

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

Nested classes/interfaces inherited from interface io.deephaven.engine.table.impl.sources.ConvertibleTimeSource

ConvertibleTimeSource.Zoned

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>

Field Summary

Fields inherited from class io.deephaven.engine.table.impl.AbstractColumnSource

componentType, type, updateGraph, USE_RANGES_AVERAGE_RUN_LENGTH

Fields inherited from interface io.deephaven.engine.table.ChunkSource

DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAY

Fields inherited from interface io.deephaven.engine.table.ChunkSource.WithPrev

ZERO_LENGTH_CHUNK_SOURCE_WITH_PREV_ARRAY

Fields inherited from interface io.deephaven.engine.table.ColumnSource

ZERO_LENGTH_COLUMN_SOURCE_ARRAY

Fields inherited from interface io.deephaven.engine.table.impl.sources.InMemoryColumnSource

TWO_DIMENSIONAL_COLUMN_SOURCE_THRESHOLD

Constructor Summary

Constructors

Constructor	Description
ImmutableConstantLongSource(long value)

Method Summary

Modifier and Type	Method	Description
<ALTERNATE_DATA_TYPE> boolean	allowsReinterpret(@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.
void	estimatePushdownFilterCost(WhereFilter filter, RowSet selection, boolean usePrev, PushdownFilterContext context, JobScheduler jobScheduler, LongConsumer onComplete, Consumer<Exception> onError)	Estimate the cost of pushing down the next pushdown filter.
final void	fillChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence)	Populates the given destination chunk with data corresponding to the keys from the given RowSequence.
void	fillChunkUnordered(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> dest, @NotNull LongChunk<? extends RowKeys> keys)	Populates a contiguous portion of the given destination chunk with data corresponding to the keys from the given LongChunk.
final void	fillPrevChunk(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> destination, @NotNull RowSequence rowSequence)	Populates the given destination chunk with data corresponding to the keys from the given RowSequence.
void	fillPrevChunkUnordered(@NotNull ChunkSource.FillContext context, @NotNull WritableChunk<? super Values> dest, @NotNull LongChunk<? extends RowKeys> keys)	Populates a contiguous portion of the given destination chunk with prev data corresponding to the keys from the given LongChunk.
final long	getLong(long rowKey)	Get the value at the rowKey as a long.
PushdownFilterContext	makePushdownFilterContext(WhereFilter filter, List<ColumnSource<?>> filterSources)	Create a pushdown filter context for this entity.
boolean	providesFillUnordered()	Returns true if this column source can efficiently provide an unordered fill.
void	pushdownFilter(WhereFilter filter, RowSet selection, boolean usePrev, PushdownFilterContext context, long costCeiling, JobScheduler jobScheduler, Consumer<PushdownResult> onComplete, Consumer<Exception> onError)	Push down the given filter to the underlying table and pass the result to the consumer.
boolean	supportsTimeConversion()	Check if this class supports time conversion.
ColumnSource<Long>	toEpochNano()	Convert this source to a long source of nanoseconds of epoch.
ColumnSource<Instant>	toInstant()	Convert this source to an Instant source.
ColumnSource<LocalDate>	toLocalDate(@NotNull ZoneId zone)	Convert this source to a LocalDate source at the specified zone.
ColumnSource<LocalTime>	toLocalTime(@NotNull ZoneId zone)	Convert this source to a LocalTime source at the specified zone.
ColumnSource<ZonedDateTime>	toZonedDateTime(@NotNull ZoneId zone)	Convert this source to a ZonedDateTime source at the specified zone.

Methods inherited from class io.deephaven.engine.table.impl.AbstractColumnSource

defaultFillChunk, defaultFillPrevChunk, getComponentType, getPrevSource, getType, match, pushdownManager, reinterpret

Methods inherited from class java.lang.Object

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

Methods 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, startTrackingPrevValues, tupleLength

Methods inherited from interface io.deephaven.engine.table.impl.ColumnSourceGetDefaults.ForLong

get

Methods inherited from interface io.deephaven.engine.table.impl.ColumnSourceGetDefaults.LongBacked

getBoolean, getByte, getChar, getDouble, getFloat, getInt, getShort

Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource

getChunk, getChunk, getChunkByFilling, makeFillContext, makeGetContext

Methods inherited from interface io.deephaven.engine.table.impl.DefaultChunkSource.WithPrev

getPrevChunk, getPrevChunk, getPrevChunkByFilling

Methods inherited from interface io.deephaven.engine.table.FillContextMaker

makeFillContext

Methods inherited from interface io.deephaven.engine.table.GetContextMaker

makeGetContext

Methods inherited from interface io.deephaven.engine.table.impl.ImmutableColumnSource

getPrev, getPrevBoolean, getPrevByte, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, getPrevShort, isImmutable

Methods inherited from interface io.deephaven.engine.table.impl.sources.InMemoryColumnSource

isInMemory

Methods inherited from interface io.deephaven.engine.table.TupleExporter

exportAllReinterpretedTo, exportAllReinterpretedTo, exportAllTo, exportElementReinterpreted

Methods inherited from interface io.deephaven.engine.table.TupleSource

createTupleFromReinterpretedValues

Constructor Details

ImmutableConstantLongSource

public ImmutableConstantLongSource(long value)

Method Details

getLong

public final long getLong(long rowKey)

Description copied from interface: ElementSource

Get the value at the rowKey as a long. RowKeys that are not present are undefined.

Specified by:

getLong in interface ElementSource<Long>

Parameters:

rowKey - the location in key space to get the value from.

Returns:

the long at the rowKey, null values are represented by QueryConstants.NULL_LONG

fillChunk

public final void fillChunk(@NotNull
 @NotNull ChunkSource.FillContext context,
 @NotNull
 @NotNull WritableChunk<? super Values> destination,
 @NotNull
 @NotNull RowSequence rowSequence)

Description copied from interface: ChunkSource

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

Specified by:

fillChunk in interface ChunkSource<Values>

Overrides:

fillChunk in class AbstractColumnSource<Long>

Parameters:

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

destination - The chunk to be populated according to rowSequence. 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 - An RowSequence representing the keys to be fetched

fillPrevChunk

public final void fillPrevChunk(@NotNull
 @NotNull ChunkSource.FillContext context,
 @NotNull
 @NotNull WritableChunk<? super Values> destination,
 @NotNull
 @NotNull RowSequence rowSequence)

Description copied from interface: ChunkSource.WithPrev

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

Specified by:

fillPrevChunk in interface ChunkSource.WithPrev<Values>

Overrides:

fillPrevChunk in class AbstractColumnSource<Long>

Parameters:

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

destination - The chunk to be populated according to rowSequence. 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 - An RowSequence representing the keys to be fetched

fillChunkUnordered

public void fillChunkUnordered(@NotNull
 @NotNull ChunkSource.FillContext context,
 @NotNull
 @NotNull WritableChunk<? super Values> dest,
 @NotNull
 @NotNull LongChunk<? extends RowKeys> keys)

Description copied from interface: FillUnordered

Populates a contiguous portion of the given destination chunk with data corresponding to the keys from the given LongChunk.

It behaves as if the following code were executed:

 destination.setSize(keys.size());
 for (int ii = 0; ii < keys.size(); ++ii) {
     destination.set(ii, get(keys.get(ii)));
 }
 

Specified by:

fillChunkUnordered in interface FillUnordered<Values>

Parameters:

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

dest - The chunk to be populated according to keys

keys - A chunk of individual, not assumed to be ordered keys to be fetched

fillPrevChunkUnordered

public void fillPrevChunkUnordered(@NotNull
 @NotNull ChunkSource.FillContext context,
 @NotNull
 @NotNull WritableChunk<? super Values> dest,
 @NotNull
 @NotNull LongChunk<? extends RowKeys> keys)

Description copied from interface: FillUnordered

Populates a contiguous portion of the given destination chunk with prev data corresponding to the keys from the given LongChunk.

It behaves as if the following code were executed:

 destination.setSize(keys.size());
 for (int ii = 0; ii < keys.size(); ++ii) {
     destination.set(ii, getPrev(keys.get(ii)));
 }
 

Specified by:

fillPrevChunkUnordered in interface FillUnordered<Values>

Parameters:

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

dest - The chunk to be populated according to keys

keys - A chunk of individual, not assumed to be ordered keys to be fetched

providesFillUnordered

public boolean providesFillUnordered()

Description copied from interface: FillUnordered

Returns true if this column source can efficiently provide an unordered fill. If this method returns false, then fillChunkUnordered and fillPrevChunkUnordered may throw an UnsupportedOperationException.

Specified by:

providesFillUnordered in interface FillUnordered<Values>

Returns:

if this column source can provide an unordered fill

makePushdownFilterContext

public PushdownFilterContext makePushdownFilterContext(WhereFilter filter,
 List<ColumnSource<?>> filterSources)

Description copied from interface: PushdownFilterMatcher

Create a pushdown filter context for this entity.

Specified by:

makePushdownFilterContext in interface PushdownFilterMatcher

Overrides:

makePushdownFilterContext in class AbstractColumnSource<Long>

Parameters:

filter - the filter to use while making the context

filterSources - the column sources that match the filter column names

Returns:

the created filter context

estimatePushdownFilterCost

public void estimatePushdownFilterCost(WhereFilter filter,
 RowSet selection,
 boolean usePrev,
 PushdownFilterContext context,
 JobScheduler jobScheduler,
 LongConsumer onComplete,
 Consumer<Exception> onError)

Description copied from interface: PushdownFilterMatcher

Estimate the cost of pushing down the next pushdown filter. This returns a unitless value to compare the cost of executing different filters. Common costs are listed in PushdownResult (such as PushdownResult.REGION_METADATA_STATS_COST) and should be used as a baseline for estimating the cost of newly implemented pushdown operations.

A no-op implementation should simply complete with Long.MAX_VALUE.

Specified by:

estimatePushdownFilterCost in interface PushdownFilterMatcher

Overrides:

estimatePushdownFilterCost in class AbstractColumnSource<Long>

Parameters:

filter - The filter to test.

selection - The set of rows to tests.

usePrev - Whether to use the previous result

context - The PushdownFilterContext to use for the pushdown operation.

jobScheduler - The job scheduler to use for scheduling child jobs

onComplete - Consumer of the estimated cost of the pushdown operation. 9223372036854775807L indicates that the filter cannot be pushed down.

onError - Consumer of any exceptions that occur during the estimate operation

pushdownFilter

public void pushdownFilter(WhereFilter filter,
 RowSet selection,
 boolean usePrev,
 PushdownFilterContext context,
 long costCeiling,
 JobScheduler jobScheduler,
 Consumer<PushdownResult> onComplete,
 Consumer<Exception> onError)

Description copied from interface: PushdownFilterMatcher

Push down the given filter to the underlying table and pass the result to the consumer. This method is expected to execute all pushdown filter steps that are greater than PushdownFilterContext.executedFilterCost() and less than or equal to costCeiling.

The resulting PushdownResult (to onComplete) must only contain rows from selection. The match row set are rows that are guaranteed to match. The implicitly "missing" rows selection - match - maybeMatch are rows that are guaranteed to not match. The remaining maybe match row set are rows that may, or may not, match. The pushdown result ownership passes to onComplete.

A no-op implementation should simply complete with PushdownResult.maybeMatch(selection).

Specified by:

pushdownFilter in interface PushdownFilterMatcher

Overrides:

pushdownFilter in class AbstractColumnSource<Long>

Parameters:

filter - The filter to apply.

selection - The set of rows to test.

usePrev - Whether to use the previous result

context - The PushdownFilterContext to use for the pushdown operation.

costCeiling - Execute all possible filters with a cost less than or equal this value.

jobScheduler - The job scheduler to use for scheduling child jobs

onComplete - Consumer of the output rowsets for added and modified rows that pass the filter

onError - Consumer of any exceptions that occur during the pushdown operation

allowsReinterpret

public <ALTERNATE_DATA_TYPE> boolean allowsReinterpret(@NotNull
 @NotNull Class<ALTERNATE_DATA_TYPE> alternateDataType)

Description copied from interface: ColumnSource

Test if a reinterpret call will succeed.

Specified by:

allowsReinterpret in interface ColumnSource<Long>

Overrides:

allowsReinterpret in class AbstractColumnSource<Long>

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: AbstractColumnSource

Supply allowed reinterpret results. The default implementation handles the most common case to avoid code duplication.

Overrides:

doReinterpret in class AbstractColumnSource<Long>

Parameters:

alternateDataType - The alternate data type

Returns:

The resulting ColumnSource

supportsTimeConversion

public boolean supportsTimeConversion()

Description copied from interface: ConvertibleTimeSource

Check if this class supports time conversion. If false, all other methods will fail.

Specified by:

supportsTimeConversion in interface ConvertibleTimeSource

Returns:

true if time conversion is supported.

toZonedDateTime

public ColumnSource<ZonedDateTime> toZonedDateTime(@NotNull
 @NotNull ZoneId zone)

Description copied from interface: ConvertibleTimeSource

Convert this source to a ZonedDateTime source at the specified zone.

Specified by:

toZonedDateTime in interface ConvertibleTimeSource

Parameters:

zone - the time zone

Returns:

a view of this source as a ZonedDateTime

toLocalDate

public ColumnSource<LocalDate> toLocalDate(@NotNull
 @NotNull ZoneId zone)

Description copied from interface: ConvertibleTimeSource

Convert this source to a LocalDate source at the specified zone.

Specified by:

toLocalDate in interface ConvertibleTimeSource

Parameters:

zone - the time zone

Returns:

a view of this source as a LocalDate

toLocalTime

public ColumnSource<LocalTime> toLocalTime(@NotNull
 @NotNull ZoneId zone)

Description copied from interface: ConvertibleTimeSource

Convert this source to a LocalTime source at the specified zone.

Specified by:

toLocalTime in interface ConvertibleTimeSource

Parameters:

zone - the time zone

Returns:

a view of this source as a LocalTime

toInstant

public ColumnSource<Instant> toInstant()

Description copied from interface: ConvertibleTimeSource

Convert this source to an Instant source.

Specified by:

toInstant in interface ConvertibleTimeSource

Returns:

a view of this source asan Instant

toEpochNano

public ColumnSource<Long> toEpochNano()

Description copied from interface: ConvertibleTimeSource

Convert this source to a long source of nanoseconds of epoch.

Specified by:

toEpochNano in interface ConvertibleTimeSource

Returns:

a view of this source as a ZonedDateTime