Package sc.bind

Class AbstractListener

java.lang.Object

sc.bind.AbstractListener

All Implemented Interfaces:

IListener

Direct Known Subclasses:

ArraySelectorBinding, DBChangeableListener, DestinationListener, RepeatListener, STagBindingListener, SyncManager.SyncChangeListener

public abstract class AbstractListener
extends java.lang.Object
implements IListener

Nested Class Summary

Nested classes/interfaces inherited from interface sc.bind.IListener

IListener.SyncType

Field Summary

Fields inherited from interface sc.bind.IListener

ARRAY_ELEMENT_CHANGED, ARRAY_ELEMENT_INVALIDATED, ARRAY_ELEMENT_VALIDATED, LISTENER_ADDED, PENDING_VALUE_SENTINEL, UNSET_VALUE_SENTINEL, VALUE_CHANGED, VALUE_CHANGED_MASK, VALUE_INVALIDATED, VALUE_REQUESTED, VALUE_VALIDATED

Constructor Summary

Constructors

Constructor	Description
AbstractListener()

Method Summary

Modifier and Type	Method	Description
void	activate(boolean state, java.lang.Object obj, boolean chained)
boolean	arrayElementChanged(java.lang.Object obj, java.lang.Object prop, java.lang.Object dims, boolean apply)
boolean	arrayElementInvalidated(java.lang.Object obj, java.lang.Object prop, java.lang.Object dims, boolean apply)
boolean	arrayElementValidated(java.lang.Object obj, java.lang.Object prop, java.lang.Object dims, boolean apply)
java.util.List<CurrentScopeContext>	getCurrentScopeContexts()
float	getPriority()
IListener.SyncType	getSync()
boolean	getTrace()	Override and return true if trace is enabled to get tracing of property-set for any property using this listener
boolean	getVerbose()
boolean	isCrossScope()
boolean	listenerAdded(java.lang.Object obj, java.lang.Object prop, java.lang.Object listener, int eventMask, int priority)
void	parentBindingChanged()	Remap Java bean style events
java.lang.Object	performCast(java.lang.Object value)	This is called by the parent binding before we apply a reverse binding.
boolean	valueChanged(java.lang.Object obj, java.lang.Object prop, java.lang.Object eventDetail, boolean apply)	Called to notify the listener of a VALUE_CHANGED event on the property srcProp.
boolean	valueInvalidated(java.lang.Object obj, java.lang.Object prop, java.lang.Object eventDetail, boolean apply)
void	valueRequested(java.lang.Object obj, java.lang.Object prop)
boolean	valueValidated(java.lang.Object obj, java.lang.Object prop, java.lang.Object eventDetail, boolean apply)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractListener

public AbstractListener()

Method Detail

getSync

public IListener.SyncType getSync()

Specified by:

getSync in interface IListener

getPriority

public float getPriority()

Specified by:

getPriority in interface IListener

valueRequested

public void valueRequested(java.lang.Object obj,
                           java.lang.Object prop)

Specified by:

valueRequested in interface IListener

valueInvalidated

public boolean valueInvalidated(java.lang.Object obj,
                                java.lang.Object prop,
                                java.lang.Object eventDetail,
                                boolean apply)

Specified by:

valueInvalidated in interface IListener

valueValidated

public boolean valueValidated(java.lang.Object obj,
                              java.lang.Object prop,
                              java.lang.Object eventDetail,
                              boolean apply)

Specified by:

valueValidated in interface IListener

valueChanged

public boolean valueChanged(java.lang.Object obj,
                            java.lang.Object prop,
                            java.lang.Object eventDetail,
                            boolean apply)

Description copied from interface: IListener

Called to notify the listener of a VALUE_CHANGED event on the property srcProp. The eventDetail may include the new value but is mainly used for debug logging. Typically code using or implementing a binding will get the current property rather than rely on the value propagated in the event since it might have changed since the delivery started.

This method returns true if the binding detected that the value had changed. False if it is detects the binding did not change. Since most listeners cache the old value, they can tell whether we need to keep processing this change. If you do not cache the old value, just return "true".

Specified by:

valueChanged in interface IListener

arrayElementChanged

public boolean arrayElementChanged(java.lang.Object obj,
                                   java.lang.Object prop,
                                   java.lang.Object dims,
                                   boolean apply)

Specified by:

arrayElementChanged in interface IListener

arrayElementValidated

public boolean arrayElementValidated(java.lang.Object obj,
                                     java.lang.Object prop,
                                     java.lang.Object dims,
                                     boolean apply)

Specified by:

arrayElementValidated in interface IListener

arrayElementInvalidated

public boolean arrayElementInvalidated(java.lang.Object obj,
                                       java.lang.Object prop,
                                       java.lang.Object dims,
                                       boolean apply)

Specified by:

arrayElementInvalidated in interface IListener

listenerAdded

public boolean listenerAdded(java.lang.Object obj,
                             java.lang.Object prop,
                             java.lang.Object listener,
                             int eventMask,
                             int priority)

Specified by:

listenerAdded in interface IListener

parentBindingChanged

public void parentBindingChanged()

Remap Java bean style events

performCast

public java.lang.Object performCast(java.lang.Object value)

This is called by the parent binding before we apply a reverse binding. It might need to do some conversion of the value before it can set it to the destination (i.e. like a float to int conversion).

activate

public void activate(boolean state,
                     java.lang.Object obj,
                     boolean chained)

getTrace

public boolean getTrace()

Description copied from interface: IListener

Override and return true if trace is enabled to get tracing of property-set for any property using this listener

Specified by:

getTrace in interface IListener

getVerbose

public boolean getVerbose()

Specified by:

getVerbose in interface IListener

isCrossScope

public boolean isCrossScope()

Specified by:

isCrossScope in interface IListener

getCurrentScopeContexts

public java.util.List<CurrentScopeContext> getCurrentScopeContexts()

Specified by:

getCurrentScopeContexts in interface IListener