Package com.illumon.iris.db.v2

Class InstrumentedListenerAdapter

java.lang.Object

com.illumon.util.referencecounting.ReferenceCounted

com.illumon.iris.db.util.liveness.ReferenceCountedLivenessNode

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

com.illumon.iris.db.v2.InstrumentedListenerBase

com.illumon.iris.db.v2.InstrumentedListener

com.illumon.iris.db.v2.InstrumentedListenerAdapter

All Implemented Interfaces:

com.fishlib.base.log.LogOutputAppendable, NotificationQueue.Dependency, LivenessManager, LivenessNode, LivenessReferent, Listener, ListenerBase, Serializable

Direct Known Subclasses:

DynamicTableToAdoConverter, TableLogger

public abstract class InstrumentedListenerAdapter
extends InstrumentedListener

This class is used for Listeners that represent "leaf" nodes in the update propagation tree. It provides an optional retention cache, to prevent listeners from being garbage collected. For creating internally ticking table nodes, instead use BaseTable.ListenerImpl

See Also:

• Serialized Form

Nested Class Summary

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

InstrumentedListener.Notification

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

InstrumentedListenerBase.ErrorNotification, InstrumentedListenerBase.NotificationBase

Field Summary

Fields

Modifier and Type	Field	Description
protected final DynamicTable	source

Constructor Summary

Constructors

Constructor	Description
InstrumentedListenerAdapter(DynamicTable source)	Create an instrumented listener for source.
InstrumentedListenerAdapter(String description, DynamicTable source)	Create an instrumented listener for source.
InstrumentedListenerAdapter(String description, DynamicTable source, boolean retain)

Method Summary

Modifier and Type	Method	Description
boolean	canExecute(long step)	Check if this listener is ready to execute.
protected void	destroy()	Attempt to release (destructively when necessary) resources held by this object.
void	onFailureInternal(Throwable originalException, UpdatePerformanceTracker.Entry sourceEntry)	Called when the source table produces an error
abstract void	onUpdate(Index added, Index removed, Index modified)	Process notification of table changes.

Methods inherited from class com.illumon.iris.db.v2.InstrumentedListener

getNotification, setInitialImage

Methods inherited from class com.illumon.iris.db.v2.InstrumentedListenerBase

append, getEntry, getErrorNotification, onFailure, onFailureInternalWithDependent, satisfied, setVerboseLogging, toString

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

manageWithCurrentScope, unmanage, unmanage

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

dropReference, getWeakReference, initializeTransientFieldsForLiveness, onReferenceCountAtZero, tryManage, tryRetainReference

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

decrementReferenceCount, incrementReferenceCount, resetReferenceCount, 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.v2.ListenerBase

getErrorNotification, onFailure

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

manage, tryManage

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

dropReference, getReferentDescription, getWeakReference, retainReference, tryRetainReference

Field Details

source

@ReferentialIntegrity
protected final DynamicTable source

Constructor Details

InstrumentedListenerAdapter

public InstrumentedListenerAdapter(DynamicTable source)

Create an instrumented listener for source. The listener will be retained and no description is provided.

Parameters:

source - The source table this listener will subscribe to - needed for preserving referential integrity.

InstrumentedListenerAdapter

public InstrumentedListenerAdapter(@Nullable
 String description,
 DynamicTable source)

Create an instrumented listener for source. The listener will be retained and no description is provided.

Parameters:

description - A description for the UpdatePerformanceTracker to append to its entry description.

source - The source table this listener will subscribe to - needed for preserving referential integrity.

InstrumentedListenerAdapter

public InstrumentedListenerAdapter(@Nullable
 String description,
 DynamicTable source,
 boolean retain)

Parameters:

description - A description for the UpdatePerformanceTracker to append to its entry description.

source - The source table this listener will subscribe to - needed for preserving referential integrity.

retain - Whether a hard reference to this listener should be maintained to prevent it from being collected.

Method Details

onUpdate

public abstract void onUpdate(Index added,
 Index removed,
 Index modified)

Description copied from interface: Listener

Process notification of table changes.

The Listener onUpdate call executes within the LiveTableMonitor refresh loop. Any tables used within the listener's onUpdate call must have already been refreshed. Using the typical pattern of a Listener that is listening to a single table, with DynamicTable.listenForUpdates(Listener), this is trivially true.

When the listener must reference more than just one parent, the tables (or other objects) it references, must be made a NotificationQueue.Dependency of the listener. For listeners that reference multiple ticking tables, a common pattern is to use a MergedListener and collection of ListenerRecorders.

Parameters:

added - rows added

removed - rows removed

modified - rows modified

onFailureInternal

public void onFailureInternal(Throwable originalException,
 UpdatePerformanceTracker.Entry sourceEntry)

Called when the source table produces an error

Specified by:

onFailureInternal in class InstrumentedListenerBase

Parameters:

originalException - the original throwable that caused this error

sourceEntry - the performance tracker entry that was active when the error occurred

canExecute

public boolean canExecute(long step)

Description copied from class: InstrumentedListenerBase

Check if this listener is ready to execute.

Overrides:

canExecute in class InstrumentedListenerBase

Returns:

if this listener is ready to execute

destroy

protected void destroy()

Description copied from class: ReferenceCountedLivenessNode

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.

Overrides:

destroy in class ReferenceCountedLivenessNode