Class AbstractVetoableValue<T>
- java.lang.Object
-
- org.eclipse.core.databinding.observable.AbstractObservable
-
- org.eclipse.core.databinding.observable.value.AbstractObservableValue<T>
-
- org.eclipse.core.databinding.observable.value.AbstractVetoableValue<T>
-
- Type Parameters:
T- the type of value being observed
- All Implemented Interfaces:
IObservable,IObservableValue<T>,IVetoableValue<T>
public abstract class AbstractVetoableValue<T> extends AbstractObservableValue<T> implements IVetoableValue<T>
This class is thread safe. All state accessing methods must be invoked from the
current realm. Methods for adding and removing listeners may be invoked from any thread.- Since:
- 1.0
-
-
Constructor Summary
Constructors Constructor Description AbstractVetoableValue()Creates a new vetoable value.AbstractVetoableValue(Realm realm)
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected voidaddListener(Object listenerType, IObservablesListener listener)voidaddValueChangingListener(IValueChangingListener<T> listener)protected Objectclone()protected abstract voiddoSetApprovedValue(T value)Sets the value.protected voiddoSetValue(T value)Template method for setting the value of the observable.protected voidfireEvent(ObservableEvent event)protected booleanfireValueChanging(ValueDiff<T> diff)Notifies listeners about a pending change, and returns true if no listener vetoed the change.protected voidfirstListenerAdded()RealmgetRealm()protected booleanhasListeners()protected voidlastListenerRemoved()protected voidremoveListener(Object listenerType, IObservablesListener listener)voidremoveValueChangingListener(IValueChangingListener<T> listener)-
Methods inherited from class org.eclipse.core.databinding.observable.value.AbstractObservableValue
addValueChangeListener, doGetValue, fireChange, fireValueChange, getValue, isStale, removeValueChangeListener, setValue
-
Methods inherited from class org.eclipse.core.databinding.observable.AbstractObservable
addChangeListener, addDisposeListener, addStaleListener, checkRealm, dispose, fireStale, isDisposed, removeChangeListener, removeDisposeListener, removeStaleListener
-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.eclipse.core.databinding.observable.IObservable
addChangeListener, addDisposeListener, addStaleListener, dispose, getRealm, isDisposed, isStale, removeChangeListener, removeDisposeListener, removeStaleListener
-
Methods inherited from interface org.eclipse.core.databinding.observable.value.IObservableValue
addValueChangeListener, getValue, getValueType, removeValueChangeListener, setValue
-
-
-
-
Constructor Detail
-
AbstractVetoableValue
public AbstractVetoableValue()
Creates a new vetoable value.
-
AbstractVetoableValue
public AbstractVetoableValue(Realm realm)
- Parameters:
realm-
-
-
Method Detail
-
doSetValue
protected final void doSetValue(T value)
Description copied from class:AbstractObservableValueTemplate method for setting the value of the observable. By default the method throws anUnsupportedOperationException.- Overrides:
doSetValuein classAbstractObservableValue<T>
-
doSetApprovedValue
protected abstract void doSetApprovedValue(T value)
Sets the value. Invoked after performing veto checks. Should not fire change events.- Parameters:
value-
-
addValueChangingListener
public void addValueChangingListener(IValueChangingListener<T> listener)
- Specified by:
addValueChangingListenerin interfaceIVetoableValue<T>
-
removeValueChangingListener
public void removeValueChangingListener(IValueChangingListener<T> listener)
- Specified by:
removeValueChangingListenerin interfaceIVetoableValue<T>
-
fireValueChanging
protected boolean fireValueChanging(ValueDiff<T> diff)
Notifies listeners about a pending change, and returns true if no listener vetoed the change.- Parameters:
diff-- Returns:
- false if the change was vetoed, true otherwise
-
addListener
protected void addListener(Object listenerType, IObservablesListener listener)
- Parameters:
listenerType-listener-
-
removeListener
protected void removeListener(Object listenerType, IObservablesListener listener)
- Parameters:
listenerType-listener-
-
hasListeners
protected boolean hasListeners()
-
fireEvent
protected void fireEvent(ObservableEvent event)
-
firstListenerAdded
protected void firstListenerAdded()
-
lastListenerRemoved
protected void lastListenerRemoved()
-
getRealm
public Realm getRealm()
- Returns:
- Returns the realm.
-
clone
protected Object clone() throws CloneNotSupportedException
- Overrides:
clonein classObject- Throws:
CloneNotSupportedException
-
-