Interface AppendableColumn<DATA_TYPE>
- All Known Subinterfaces:
BufferedAppendableColumn<DATA_TYPE>
- All Known Implementing Classes:
ArrayVariableWidthObjectLocalAppendableColumn
,BaseAppendableColumn
,BlobStreamAppendableColumn
,BufferVariableWidthObjectLocalAppendableColumn
,CharSequenceLocalAppendableColumn
,CompressedStringLocalAppendableColumn
,DateTimeLocalAppendableColumn
,DateTimeStreamAppendableColumn
,ExternalizableLocalAppendableColumn
,ExternalizableStreamAppendableColumn
,FixedWidthObjectCodecLocalAppendableColumn
,InstantLocalAppendableColumn
,LocalAppendableColumn
,NanosBackedTimeAppendableColumn
,SerializableLocalAppendableColumn
,SerializableStreamAppendableColumn
,StreamAppendableColumn
,StringLocalAppendableColumn
,StringStreamAppendableColumn
,SymbolLocalAppendableColumn
,SymbolManagerLocalAppendableColumn
,SymbolSetLocalAppendableColumn
,VariableWidthObjectCodecLocalAppendableColumn
,VariableWidthObjectLocalAppendableColumn
public interface AppendableColumn<DATA_TYPE>
Appendable columns for ordered output.
-
Field Summary
Fields Modifier and Type Field Description static int
DEFAULT_CHUNK_CAPACITY
The default capacity for chunked appends. -
Method Summary
Modifier and Type Method Description void
add(DATA_TYPE value)
Append a DATA_TYPE to this column.void
add(DATA_TYPE[] values, int startIndex, int length)
Add DATA_TYPE values from an array.void
add(DATA_TYPE value, long count)
Append a DATA_TYPE to this columncount
times.void
addBoolean(Boolean value)
Append a Boolean to this column.void
addBoolean(Boolean value, long count)
Append a Boolean to this columncount
times.void
addBooleans(Boolean[] values, int startIndex, int length)
Add Boolean values from an array.void
addByte(byte value)
Append a byte to this column.void
addByte(byte value, long count)
Append a byte to this columncount
times.void
addBytes(byte[] values, int startIndex, int length)
Add byte values from an array.void
addBytes(ByteBuffer buffer)
Add byte values from a ByteBuffer, starting at buffer.position() and continuing to buffer.limit().void
addChar(char value)
Append a char to this column.void
addChar(char value, long count)
Append a char to this columncount
times.void
addChars(char[] values, int startIndex, int length)
Add char values from an array.void
addDouble(double value)
Append a double to this column.void
addDouble(double value, long count)
Append a double to this columncount
times.void
addDoubles(double[] values, int startIndex, int length)
Add double values from an array.void
addFloat(float value)
Append a float to this column.void
addFloat(float value, long count)
Append a float to this columncount
times.void
addFloats(float[] values, int startIndex, int length)
Add float values from an array.default void
addFromArray(Object array, int startIndex, int length)
Add values from an array of the "correct" type.void
addFromBooleanChunk(ObjectChunk<Boolean,? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.default void
addFromBoxedValue(DATA_TYPE value)
Add a value, with type-specific unboxing and null-conversion for primitive wrapper classes.default void
addFromBoxedValue(DATA_TYPE value, long count)
Add a value multiple times, with type-specific unboxing and null-conversion for primitive wrapper classes.void
addFromByteChunk(ByteChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromCharChunk(CharChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.default void
addFromChunk(Chunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.default void
addFromChunkSource(ChunkSource.GetContext context, ChunkSource<? extends Attributes.Values> source, OrderedKeys orderedKeys)
Get a chunk of values fromsource
, and add them all.default void
addFromChunkSource(ChunkSource<? extends Attributes.Values> source, OrderedKeys orderedKeys, int chunkCapacity)
Add all values fromsource
specified byorderedKeys
in units ofchunkCapacity
.default void
addFromChunkSource(ChunkSource<? extends Attributes.Values> source, OrderedKeys orderedKeys, int chunkCapacity, SharedContext sharedContext)
Add all values fromsource
specified byorderedKeys
in units ofchunkCapacity
.default void
addFromColumnSource(ColumnSource<DATA_TYPE> source, long sourceKey)
Deprecated.default void
addFromColumnSource(ColumnSource<DATA_TYPE> source, long[] sourceKeys)
Deprecated.default void
addFromColumnSource(ColumnSource<DATA_TYPE> source, Index index)
Deprecated.default void
addFromColumnSource(ColumnSource<DATA_TYPE> source, PrimitiveIterator.OfLong keyIterator)
Deprecated.default void
addFromDataColumn(DataColumn<DATA_TYPE> source, int sourcePosition)
Deprecated.void
addFromDoubleChunk(DoubleChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromFloatChunk(FloatChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromIntChunk(IntChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromLongChunk(LongChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromObjectChunk(ObjectChunk<DATA_TYPE,? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addFromShortChunk(ShortChunk<? extends Attributes.Values> source)
Add all values fromsource
in the range[0, source.size())
.void
addInt(int value)
Append a int to this column.void
addInt(int value, long count)
Append a int to this columncount
times.void
addInts(int[] values, int startIndex, int length)
Add int values from an array.void
addLong(long value)
Append a long to this column.void
addLong(long value, long count)
Append a long to this columncount
times.void
addLongs(long[] values, int startIndex, int length)
Add long values from an array.void
addShort(short value)
Append a short to this column.void
addShort(short value, long count)
Append a short to this columncount
times.void
addShorts(short[] values, int startIndex, int length)
Add short values from an array.void
close()
Persist all added data and release any system resources consumed by this column.void
force()
Persist all added data.default AppendableColumnAddHelper<DATA_TYPE>
getAddHelper()
Get a type-appropriate helper instance for complex append operations.String
getName()
The name of this column in the enclosing table.Class<DATA_TYPE>
getType()
-
Field Details
-
DEFAULT_CHUNK_CAPACITY
static final int DEFAULT_CHUNK_CAPACITYThe default capacity for chunked appends.
-
-
Method Details
-
getName
String getName()The name of this column in the enclosing table.- Returns:
- The name of this column
-
getType
- Returns:
- the type of object contained within this column.
-
getAddHelper
Get a type-appropriate helper instance for complex append operations.- Returns:
- An add-helper for this column
-
force
void force()Persist all added data. -
close
void close()Persist all added data and release any system resources consumed by this column. -
addBoolean
Append a Boolean to this column.- Parameters:
value
- The value to append
-
addByte
void addByte(byte value)Append a byte to this column.- Parameters:
value
- The value to append
-
addChar
void addChar(char value)Append a char to this column.- Parameters:
value
- The value to append
-
addDouble
void addDouble(double value)Append a double to this column.- Parameters:
value
- The value to append
-
addFloat
void addFloat(float value)Append a float to this column.- Parameters:
value
- The value to append
-
addInt
void addInt(int value)Append a int to this column.- Parameters:
value
- The value to append
-
addLong
void addLong(long value)Append a long to this column.- Parameters:
value
- The value to append
-
addShort
void addShort(short value)Append a short to this column.- Parameters:
value
- The value to append
-
add
Append a DATA_TYPE to this column.- Parameters:
value
- The value to append
-
addBoolean
Append a Boolean to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addByte
void addByte(byte value, long count)Append a byte to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addChar
void addChar(char value, long count)Append a char to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addDouble
void addDouble(double value, long count)Append a double to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addFloat
void addFloat(float value, long count)Append a float to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addInt
void addInt(int value, long count)Append a int to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addLong
void addLong(long value, long count)Append a long to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addShort
void addShort(short value, long count)Append a short to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
add
Append a DATA_TYPE to this columncount
times.- Parameters:
value
- The value to appendcount
- The number of times to append the value
-
addBooleans
Add Boolean values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addBytes
void addBytes(@NotNull byte[] values, int startIndex, int length)Add byte values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addBytes
Add byte values from a ByteBuffer, starting at buffer.position() and continuing to buffer.limit().- Parameters:
buffer
- The buffer
-
addChars
void addChars(@NotNull char[] values, int startIndex, int length)Add char values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addDoubles
void addDoubles(@NotNull double[] values, int startIndex, int length)Add double values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addFloats
void addFloats(@NotNull float[] values, int startIndex, int length)Add float values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addInts
void addInts(@NotNull int[] values, int startIndex, int length)Add int values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addLongs
void addLongs(@NotNull long[] values, int startIndex, int length)Add long values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addShorts
void addShorts(@NotNull short[] values, int startIndex, int length)Add short values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
add
Add DATA_TYPE values from an array.- Parameters:
values
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addFromDataColumn
@Deprecated default void addFromDataColumn(@NotNull DataColumn<DATA_TYPE> source, int sourcePosition)Deprecated.Add a value described by its position from a DataColumn.- Parameters:
source
- The source DataColumnsourcePosition
- The position within source that contains the value to be added
-
addFromColumnSource
@Deprecated default void addFromColumnSource(@NotNull ColumnSource<DATA_TYPE> source, long sourceKey)Deprecated.Add a value described by its key from a ColumnSource.- Parameters:
source
- The source ColumnSourcesourceKey
- The key within source that contains the value to be added
-
addFromColumnSource
@Deprecated default void addFromColumnSource(@NotNull ColumnSource<DATA_TYPE> source, @NotNull long[] sourceKeys)Deprecated.Add values described by an array of their keys from a ColumnSource.- Parameters:
source
- The source ColumnSourcesourceKeys
- The keys within source that contain the values to be added
-
addFromColumnSource
@Deprecated default void addFromColumnSource(@NotNull ColumnSource<DATA_TYPE> source, @NotNull Index index)Deprecated.Add values described by an Index from a ColumnSource.- Parameters:
source
- The source ColumnSourceindex
- An index whose keys within source contain the values to be added
-
addFromColumnSource
@Deprecated default void addFromColumnSource(@NotNull ColumnSource<DATA_TYPE> source, @NotNull PrimitiveIterator.OfLong keyIterator)Deprecated.Add values supplied by an iterator from a ColumnSource.- Parameters:
source
- The source ColumnSourcekeyIterator
- An iterator of keys within source that contain the values to be added
-
addFromBoxedValue
Add a value, with type-specific unboxing and null-conversion for primitive wrapper classes.- Parameters:
value
- The value to add
-
addFromBoxedValue
Add a value multiple times, with type-specific unboxing and null-conversion for primitive wrapper classes.- Parameters:
value
- The value to addcount
- The number of times to add the value
-
addFromArray
Add values from an array of the "correct" type. That is, a primitive array for columns of a primitive type, and an appropriately typed array of objects for all other columns. Non-array or incorrect types may result in an exception or undefined behavior.- Parameters:
array
- The array of valuesstartIndex
- The index of the first value to addlength
- The total number of values to add
-
addFromBooleanChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceObjectChunk
-
addFromByteChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceByteChunk
-
addFromCharChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceCharChunk
-
addFromDoubleChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceDoubleChunk
-
addFromFloatChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceFloatChunk
-
addFromIntChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceIntChunk
-
addFromLongChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceLongChunk
-
addFromShortChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceShortChunk
-
addFromObjectChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceObjectChunk
-
addFromChunk
Add all values fromsource
in the range[0, source.size())
.- Parameters:
source
- The sourceChunk
-
addFromChunkSource
default void addFromChunkSource(@NotNull ChunkSource<? extends Attributes.Values> source, @NotNull OrderedKeys orderedKeys, int chunkCapacity)Add all values fromsource
specified byorderedKeys
in units ofchunkCapacity
.- Parameters:
source
- TheChunkSource
to get values fromorderedKeys
- The keys to get fromsource
chunkCapacity
- The unit of work forChunkSource.getChunk(ChunkSource.GetContext, OrderedKeys)
andaddFromChunk(Chunk)
-
addFromChunkSource
default void addFromChunkSource(@NotNull ChunkSource<? extends Attributes.Values> source, @NotNull OrderedKeys orderedKeys, int chunkCapacity, @Nullable SharedContext sharedContext)Add all values fromsource
specified byorderedKeys
in units ofchunkCapacity
.- Parameters:
source
- TheChunkSource
to get values fromorderedKeys
- The keys to get fromsource
chunkCapacity
- The unit of work forChunkSource.getChunk(ChunkSource.GetContext, OrderedKeys)
andaddFromChunk(Chunk)
sharedContext
- An optionalSharedContext
for use in creating aChunkSource.GetContext
-
addFromChunkSource
default void addFromChunkSource(@NotNull ChunkSource.GetContext context, @NotNull ChunkSource<? extends Attributes.Values> source, @NotNull OrderedKeys orderedKeys)Get a chunk of values fromsource
, and add them all.- Parameters:
context
- AChunkSource.GetContext
made fromsource
source
- TheChunkSource
to get values fromorderedKeys
- The keys to get fromsource
-