Class ColumnRegionObjectCodecVariable<T,ATTR extends Attributes.Any>
java.lang.Object
com.illumon.iris.db.v2.sources.regioned.ColumnRegionObjectCodecVariable<T,ATTR>
- Type Parameters:
T- The realized type of the encoded objects within this regionATTR- The Chunk attribute for this region
- All Implemented Interfaces:
ChunkSource<ATTR>,DefaultChunkSource<ATTR>,FillContextMaker,GetContextMaker,Page<ATTR>,Page.WithDefaults<ATTR>,PagingChunkSource<ATTR>,ColumnRegion<ATTR>,ColumnRegionObject<T,ATTR>,Releasable
public final class ColumnRegionObjectCodecVariable<T,ATTR extends Attributes.Any> extends Object implements ColumnRegionObject<T,ATTR>, Page.WithDefaults<ATTR>
A
ColumnRegion for non-primitive types that have a variable size. Objects are stored within two underlying
files.
The Offset file contains the byte offsets within the binary file for each index within the region. When reading from the binary file, we use offset at the previous index as the starting offset for the object and the offset at the current index as the ending offset within the binary file for the object.
The binary file contains the raw bytes of each object as encoded by the ObjectDecoder, which is typically
defined as the codec at the schema level for a table.
-
Nested Class Summary
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.regioned.ColumnRegionObject
ColumnRegionObject.DictionaryKeysWrapper, ColumnRegionObject.IntDictionaryKeysWrapper, ColumnRegionObject.Null<T,ATTR extends Attributes.Any>, ColumnRegionObject.StaticPageStore<DATA_TYPE,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>Nested classes/interfaces inherited from interface com.illumon.iris.db.v2.sources.chunk.page.Page
Page.WithDefaults<ATTR extends Attributes.Any>, Page.WithDefaultsForRepeatingValues<ATTR extends Attributes.Any> -
Field Summary
Fields inherited from interface com.illumon.iris.db.v2.sources.chunk.ChunkSource
DEFAULT_FILL_INSTANCE, ZERO_LENGTH_CHUNK_SOURCE_ARRAY -
Constructor Summary
Constructors Constructor Description ColumnRegionObjectCodecVariable(Class<T> nativeType, ObjectDecoder<T> decoder, ColumnRegionLong<Attributes.OrderedKeyIndices> offsetData, ColumnRegionByte<Attributes.EncodedObjects> binaryData) -
Method Summary
Modifier and Type Method Description voidfillChunkAppend(ChunkSource.FillContext fillContext, WritableChunk<? super ATTR> destination, OrderedKeys orderedKeys)Appends the values referenced byorderKeysontodestination.Class<T>getNativeType()TgetObject(long elementIndex)Get a single object from this region.TgetObject(ChunkSource.FillContext context, long elementIndex)Get a single object from this region.longlength()voidreleaseCachedResources()Release any resources held for caching purposes.Methods 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.regioned.ColumnRegion
firstRowOffset, maskMethods inherited from interface com.illumon.iris.db.v2.sources.regioned.ColumnRegionObject
gatherDictionaryValuesRowSet, getDictionaryKeysRegion, getDictionaryKeysRegionInt, getDictionaryRegionType, getDictionaryValuesRegion, skipCache, supportsDictionaryFormatMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.DefaultChunkSource
getChunk, getChunk, getChunkByFilling, makeFillContext, makeGetContextMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.FillContextMaker
makeFillContextMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.GetContextMaker
makeGetContextMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.page.Page
advanceToNextPage, advanceToNextPage, advanceToNextPageAndGetPositionDistance, firstRow, getRowOffset, lastRowMethods inherited from interface com.illumon.iris.db.v2.sources.chunk.page.Page.WithDefaults
fillChunk, fillChunkAppend
-
Constructor Details
-
ColumnRegionObjectCodecVariable
public ColumnRegionObjectCodecVariable(@NotNull Class<T> nativeType, @NotNull ObjectDecoder<T> decoder, @NotNull ColumnRegionLong<Attributes.OrderedKeyIndices> offsetData, @NotNull ColumnRegionByte<Attributes.EncodedObjects> binaryData)
-
-
Method Details
-
getObject
Description copied from interface:ColumnRegionObjectGet a single object from this region.- Specified by:
getObjectin interfaceColumnRegionObject<T,ATTR extends Attributes.Any>- Parameters:
elementIndex- Element (object) index in the table's address space- Returns:
- The object value at the specified element (object) index
-
getObject
Description copied from interface:ColumnRegionObjectGet a single object from this region.- Specified by:
getObjectin interfaceColumnRegionObject<T,ATTR extends Attributes.Any>- Parameters:
context- AColumnRegionFillContextto enable resource caching where suitable, with current region index pointing to this regionelementIndex- Element (object) index in the table's address space- Returns:
- The object value at the specified element (object) index
-
fillChunkAppend
public void fillChunkAppend(@NotNull ChunkSource.FillContext fillContext, @NotNull WritableChunk<? super ATTR> destination, @NotNull OrderedKeys orderedKeys)Description copied from interface:Page.WithDefaultsAppends the values referenced byorderKeysontodestination.orderKeysare assumed to be entirely contained on thisPage.- Specified by:
fillChunkAppendin interfacePage.WithDefaults<T>
-
getNativeType
- Specified by:
getNativeTypein interfaceChunkSource<T>- Specified by:
getNativeTypein interfaceColumnRegionObject<T,ATTR extends Attributes.Any>
-
length
public long length() -
releaseCachedResources
@OverridingMethodsMustInvokeSuper public void releaseCachedResources()Description copied from interface:ReleasableRelease any resources held for caching purposes. Implementations need not guarantee that they are safe for normal use concurrently with invocations of this method.- Specified by:
releaseCachedResourcesin interfaceReleasable
-