Package io.deephaven.engine.table.impl

Class ContextWithChunk<ATTR extends Any,CONTEXT extends Context>

java.lang.Object

io.deephaven.engine.table.impl.ContextWithChunk<ATTR,CONTEXT>

All Implemented Interfaces:

Context, SafeCloseable, AutoCloseable

Direct Known Subclasses:

DefaultGetContext

public class ContextWithChunk<ATTR extends Any,CONTEXT extends Context>
extends Object
implements Context

Method Summary

Modifier and Type	Method	Description
void	close()	Release any resources associated with this context.
void	ensureSize(int length)	Makes sure that the internal array (and hence the writableChunk) is at least the specified size.
CONTEXT	getContext()
static <CONTEXT extends Context> CONTEXT	getContext(@NotNull Context context)
ResettableChunk<ATTR>	getResettableChunk()
static <ATTR extends Any, RESETTABLE_WRITABLE_CHUNK extends ResettableWritableChunk<ATTR>> RESETTABLE_WRITABLE_CHUNK	getResettableChunk(@NotNull Context context)
WritableChunk<ATTR>	getWritableChunk()
static <ATTR extends Any, WRITABLE_CHUNK extends WritableChunk<ATTR>> WRITABLE_CHUNK	getWritableChunk(@NotNull Context context)
static <ATTR extends Any> boolean	isMyResettableChunk(@NotNull Context context, Chunk<ATTR> chunk)	Checks if this chunk is the result of a call to getResettableChunk() or getResettableChunk(Context) with this context, followed by a some reset call, including the result of a call to resetChunkFromArray(Context, Object, int, int).
static <ATTR extends Any> boolean	isMyWritableChunk(@NotNull Context context, Chunk<ATTR> chunk)	Checks if this chunk is the result of a call to getWritableChunk() or getWritableChunk(Context) with this context.
static <ATTR extends Any, CHUNK extends Chunk<ATTR>> CHUNK	resetChunkFromArray(@NotNull Context context, Object array, int offset, int length)

Methods inherited from class java.lang.Object

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

Method Details

close

public void close()

Description copied from interface: Context

Release any resources associated with this context. The context should not be used afterwards.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Context

Specified by:

close in interface SafeCloseable

getWritableChunk

public WritableChunk<ATTR> getWritableChunk()

Returns:

a WritableChunk which you can use for results

ApiNote:

the chunk is valid until the next call to this function, getResettableChunk(), getWritableChunk(Context), getResettableChunk(Context), or resetChunkFromArray(Context, Object, int, int) for this context.

getResettableChunk

public ResettableChunk<ATTR> getResettableChunk()

Returns:

a ResettableChunk chunk which you can use for results by calling one of its various reset methods.

ApiNote:

the chunk is valid until the next call to this function, getWritableChunk(), getWritableChunk(Context), getResettableChunk(Context), or resetChunkFromArray(Context, Object, int, int) for this context.

getContext

public CONTEXT getContext()

Returns:

The context held in this Context

getContext

public static <CONTEXT extends Context> CONTEXT getContext(@NotNull
 @NotNull Context context)

Returns:

The context held in this Context

ensureSize

public void ensureSize(int length)

Makes sure that the internal array (and hence the writableChunk) is at least the specified size.

getWritableChunk

public static <ATTR extends Any,
WRITABLE_CHUNK extends WritableChunk<ATTR>>
WRITABLE_CHUNK getWritableChunk(@NotNull
 @NotNull Context context)

Parameters:

context - The context that owns the reusable chunk

Returns:

a WritableChunk which you can use for results. The size will be set to 0.

ApiNote:

the chunk is valid until the next call to this function, getWritableChunk(), getResettableChunk(), getResettableChunk(Context), or resetChunkFromArray(Context, Object, int, int) for this context.

getResettableChunk

public static <ATTR extends Any,
RESETTABLE_WRITABLE_CHUNK extends ResettableWritableChunk<ATTR>>
RESETTABLE_WRITABLE_CHUNK getResettableChunk(@NotNull
 @NotNull Context context)

Parameters:

context - The context that owns the reusable chunk

Returns:

a ResettableWritableChunk, which you can use for results by using one of its various reset methods.

ApiNote:

the chunk is valid until the next call to this function, getWritableChunk(), getResettableChunk(), getWritableChunk(Context), resetChunkFromArray(Context, Object, int, int) for this context.

resetChunkFromArray

public static <ATTR extends Any,
CHUNK extends Chunk<ATTR>>
CHUNK resetChunkFromArray(@NotNull
 @NotNull Context context,
 Object array,
 int offset,
 int length)

Parameters:

context - The context that owns the reusable chunk

array - The array to alias. If this is null, returns a null-value filled chunk.

offset - The offset in the array for the beginning of the chunk

length - The length of the chunk

Returns:

A chunk which aliases the region of the array which can be used for results.

ApiNote:

the chunk is valid until the next call to this function, getWritableChunk(), getResettableChunk(), getWritableChunk(Context), or getResettableChunk(Context) for this context.

isMyWritableChunk

public static <ATTR extends Any> boolean isMyWritableChunk(@NotNull
 @NotNull Context context,
 Chunk<ATTR> chunk)

Checks if this chunk is the result of a call to getWritableChunk() or getWritableChunk(Context) with this context. This is primarily intended for testing and verification code.

isMyResettableChunk

public static <ATTR extends Any> boolean isMyResettableChunk(@NotNull
 @NotNull Context context,
 Chunk<ATTR> chunk)

Checks if this chunk is the result of a call to getResettableChunk() or getResettableChunk(Context) with this context, followed by a some reset call, including the result of a call to resetChunkFromArray(Context, Object, int, int). This is primarily intended for testing and verification code.