Package io.deephaven.engine.table.impl

Class UncoalescedTableImpl<IMPL_TYPE extends UncoalescedTable<IMPL_TYPE>>

java.lang.Object
io.deephaven.util.referencecounting.ReferenceCounted
io.deephaven.engine.liveness.ReferenceCountedLivenessReferent
io.deephaven.engine.liveness.ReferenceCountedLivenessNode
io.deephaven.engine.liveness.LivenessArtifact
io.deephaven.engine.table.impl.LiveAttributeMap<Table,IMPL_TYPE>
io.deephaven.engine.table.impl.BaseGridAttributes<Table,IMPL_TYPE>
io.deephaven.engine.table.impl.BaseTable<IMPL_TYPE>
io.deephaven.engine.table.impl.UncoalescedTable<IMPL_TYPE>
io.deephaven.engine.table.impl.UncoalescedTableImpl<IMPL_TYPE>
Type Parameters:
IMPL_TYPE - the specific type of UncoalescedTable that this class implements, used for covariant return types
All Implemented Interfaces:
TableOperations<Table,Table>, TableOperationsDefaults<Table,Table>, LogOutputAppendable, LivenessManager, LivenessNode, LivenessReferent, AttributeMap<Table>, GridAttributes<Table>, HasParentPerformanceIds, NotificationStepReceiver, NotificationStepSource, TableDefaults, Table, DynamicNode, NotificationQueue.Dependency, SystemicObject<Table>, LongSizedDataStructure, Serializable
Direct Known Subclasses:
RedefinableTable
public abstract class UncoalescedTableImpl<IMPL_TYPE extends UncoalescedTable<IMPL_TYPE>> extends UncoalescedTable<IMPL_TYPE>
The standard implementation of an UncoalescedTable.

When the Table is coalesced, a hard reference is stored to the result. Any future coalesce() call reuses the same result if it is static or remains live. If the coalesce operation is context dependent, then you must directly extend UncoalescedTable instead of extending UncoalescedTableImpl.

See Also:

  • Constructor Details

    • UncoalescedTableImpl

      protected UncoalescedTableImpl(@NotNull @NotNull TableDefinition definition, @NotNull @NotNull String description)

  • Method Details

    • doCoalesce

      protected abstract Table doCoalesce()
      Produce the actual coalesced result table, suitable for caching.

      Note that if this table must have listeners registered, etc, setting these up is the implementation's responsibility.

      Also note that the implementation should copy attributes, as in copyAttributes(resultTable, CopyAttributeOperation.Coalesce).

      Returns:
      The coalesced result table, suitable for caching

    • coalesce

      public final Table coalesce()
      Description copied from interface: Table
      Explicitly ensure that any work needed to make a table addressable, iterable, or queryable has been done, and return the coalesced child table if appropriate.
      Specified by:
      coalesce in interface Table
      Specified by:
      coalesce in interface TableDefaults
      Specified by:
      coalesce in class UncoalescedTable<IMPL_TYPE extends UncoalescedTable<IMPL_TYPE>>
      Returns:
      This table, or a fully-coalesced child

    • setCoalesced

      protected final void setCoalesced(Table coalesced)
      Proactively set the coalesced result table. See doCoalesce() for the caller's responsibilities. Note that it is an error to call this more than once with a non-null input.
      Parameters:
      coalesced - The coalesced result table, suitable for caching

    • getCoalesced

      @Nullable protected final @Nullable Table getCoalesced()