Package com.illumon.iris.db.tables.remote

Class ViewportColumnSource<T>

java.lang.Object

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

com.illumon.iris.db.tables.remote.ViewportColumnSource<T>

All Implemented Interfaces:

RemoteTableHandleManager.CloseableViewportColumn, ChunkSource<Attributes.Values>, ChunkSource.WithPrev<Attributes.Values>, DefaultChunkSource<Attributes.Values>, DefaultChunkSource.WithPrev<Attributes.Values>, FillContextMaker, GetContextMaker, ColumnSource<T>, ElementSource<T>, Releasable, TupleExporter<T>, TupleSource<T>, Serializable

public abstract class ViewportColumnSource<T>
extends AbstractColumnSource<T>
implements RemoteTableHandleManager.CloseableViewportColumn

ColumnSource used by RemoteTableHandles, backed by a ReplicatedTable viewport. The get() operations will open a viewport (if not already open); and then wait for the accessed cell to become populated before returning it.

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.chunk.DefaultChunkSource

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

Field Summary

Fields

Modifier and Type	Field	Description
protected static Runnable	pregetCallback
protected final ViewportColumnTableHolder	viewportColumnTableHolder

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

Constructor Summary

Constructors

Constructor	Description
ViewportColumnSource(Class<T> type, RemoteTableHandle.TableProxy tableProxy, int columnIndex, String sourceName)

Method Summary

Modifier and Type	Method	Description
protected void	doPregetCallback()	Get a local copy of the pre-get callback, and execute it if non-null.
T	getPrev(long index)	Get the previous value at the index.
boolean	isImmutable()	Determine if this column source is immutable, meaning that the values at a given index key never change.
void	maybeCloseViewport()
static void	setPregetCallback(Runnable callback)	Invoke this callback before each get operation.

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

allowsReinterpret, canUseGrouping, defaultFillChunk, doReinterpret, fillChunk, fillPrevChunk, getComponentType, getGroupingBuilder, getGroupingProvider, getNativeType, getType, hasGrouping, isSerializable, match, matchWithGrouping, 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

getChunkType

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

cast, createPreviousTuple, createTuple, createTupleFromValues, exportElement, exportElement, exportToExternalKey, getColumnSources, getPrevSource, releaseCachedResources, startTrackingPrevValues

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

getChunk, getChunk, getChunkByFilling, makeFillContext, makeGetContext

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

getPrevChunk, getPrevChunk, getPrevChunkByFilling

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

get, getBoolean, getByte, getChar, getDouble, getFloat, getInt, getLong, getPrevBoolean, getPrevByte, getPrevChar, getPrevDouble, getPrevFloat, getPrevInt, getPrevLong, 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.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

Field Details

pregetCallback

protected static volatile Runnable pregetCallback

viewportColumnTableHolder

protected final ViewportColumnTableHolder viewportColumnTableHolder

Constructor Details

ViewportColumnSource

public ViewportColumnSource(@NotNull
 Class<T> type,
 @NotNull
 RemoteTableHandle.TableProxy tableProxy,
 int columnIndex,
 String sourceName)

Method Details

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.

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

maybeCloseViewport

public void maybeCloseViewport()

Specified by:

maybeCloseViewport in interface RemoteTableHandleManager.CloseableViewportColumn

setPregetCallback

public static void setPregetCallback(Runnable callback)

Invoke this callback before each get operation. The intended use is to check for invalid usage of ViewportColumnSources on the Swing EDT.

Parameters:

callback - the callback to invoke before get

doPregetCallback

protected void doPregetCallback()

Get a local copy of the pre-get callback, and execute it if non-null.