Package com.illumon.iris.db.v2

Class SourceTable.QueryTableReference

java.lang.Object

com.illumon.util.referencecounting.ReferenceCounted

com.illumon.iris.db.util.liveness.LivenessArtifact

com.illumon.iris.db.v2.DeferredViewTable.TableReference

com.illumon.iris.db.v2.SourceTable.QueryTableReference

All Implemented Interfaces:

com.fishlib.base.log.LogOutputAppendable, com.fishlib.base.reference.SimpleReference<Table>, LivenessManager, LivenessNode, LivenessReferent, Serializable

Enclosing class:

SourceTable

protected static class SourceTable.QueryTableReference
extends DeferredViewTable.TableReference

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.illumon.iris.db.v2.DeferredViewTable.TableReference

DeferredViewTable.TableReference.TableAndRemainingFilters

Field Summary

Fields

Modifier and Type	Field	Description
protected SourceTable	table

Method Summary

Modifier and Type	Method	Description
protected void	destroy()	Attempt to release (destructively when necessary) resources held by this object.
void	dropReference()	Drop a previously-retained reference to this referent.
Table	get()	Returns the table in a form that the user can run queries on it.
TableDefinition	getDefinition()	Get the definition, without instantiating it.
long	getSize()	What size should the uninitialized table return.
WeakReference<? extends LivenessReferent>	getWeakReference()	Get a WeakReference to this referent.
void	initializeTransientFieldsForLiveness()	Package-private for Serializable sub-classes to use in readObject only.
protected void	onReferenceCountAtZero()	Callback method that will be invoked when the reference count returns to zero.
boolean	tryManage(LivenessReferent referent)	Attempt to add the specified referent to this manager.
boolean	tryRetainReference()	If this referent is "live", behave as LivenessReferent.retainReference() and return true.

Methods inherited from class com.illumon.iris.db.v2.DeferredViewTable.TableReference

clear, getWithWhere, selectDistinct

Methods inherited from class com.illumon.iris.db.util.liveness.LivenessArtifact

manageWithCurrentScope, unmanage, unmanage

Methods inherited from class com.illumon.util.referencecounting.ReferenceCounted

append, decrementReferenceCount, incrementReferenceCount, resetReferenceCount, toString, tryDecrementReferenceCount, tryIncrementReferenceCount

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.illumon.iris.db.util.liveness.LivenessManager

manage

Methods inherited from interface com.illumon.iris.db.util.liveness.LivenessReferent

getReferentDescription, retainReference

Field Details

table

protected final SourceTable table

Method Details

getSize

public long getSize()

Description copied from class: DeferredViewTable.TableReference

What size should the uninitialized table return.

Specified by:

getSize in class DeferredViewTable.TableReference

Returns:

getDefinition

public TableDefinition getDefinition()

Description copied from class: DeferredViewTable.TableReference

Get the definition, without instantiating it.

Specified by:

getDefinition in class DeferredViewTable.TableReference

Returns:

The definition of the table we are referring to

get

public Table get()

Description copied from class: DeferredViewTable.TableReference

Returns the table in a form that the user can run queries on it. This may be as simple as returning a reference, but for amorphous tables, this means we need to do the work to instantiate it.

Specified by:

get in interface com.fishlib.base.reference.SimpleReference<Table>

Specified by:

get in class DeferredViewTable.TableReference

initializeTransientFieldsForLiveness

@VisibleForTesting public final void initializeTransientFieldsForLiveness()

Package-private for Serializable sub-classes to use in readObject only. Public to allow unit tests in another package to work around mock issues where the constructor is never invoked.

tryRetainReference

public final boolean tryRetainReference()

Description copied from interface: LivenessReferent

If this referent is "live", behave as LivenessReferent.retainReference() and return true. Otherwise, returns false rather than throwing an exception.

Specified by:

tryRetainReference in interface LivenessReferent

Returns:

True if this referent was retained, false otherwise

dropReference

public final void dropReference()

Description copied from interface: LivenessReferent

Drop a previously-retained reference to this referent.

Specified by:

dropReference in interface LivenessReferent

getWeakReference

public WeakReference<? extends LivenessReferent> getWeakReference()

Description copied from interface: LivenessReferent

Get a WeakReference to this referent. This may be cached, or newly created.

Specified by:

getWeakReference in interface LivenessReferent

Returns:

A new or cached reference to this referent

tryManage

public final boolean tryManage(@NotNull LivenessReferent referent)

Description copied from interface: LivenessManager

Attempt to add the specified referent to this manager.

Specified by:

tryManage in interface LivenessManager

Parameters:

referent - The referent to add

Returns:

Whether the referent was in fact added

destroy

protected void destroy()

Attempt to release (destructively when necessary) resources held by this object. This may render the object unusable for subsequent operations. Implementations should be sure to call super.destroy().

This is intended to only ever be used as a side effect of decreasing the reference count to 0.

onReferenceCountAtZero

protected final void onReferenceCountAtZero()

Description copied from class: ReferenceCounted

Callback method that will be invoked when the reference count returns to zero.

Specified by:

onReferenceCountAtZero in class ReferenceCounted