Class AbstractObservable
- java.lang.Object
-
- org.eclipse.core.databinding.observable.AbstractObservable
-
- All Implemented Interfaces:
IObservable
- Direct Known Subclasses:
AbstractObservableSet,AbstractObservableValue,DecoratingObservable,ObservableList,ObservableMap,ObservableSet
public abstract class AbstractObservable extends Object implements IObservable
- Since:
- 1.0
-
-
Constructor Summary
Constructors Constructor Description AbstractObservable(Realm realm)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddChangeListener(IChangeListener listener)Adds the given change listener to the list of change listeners.voidaddDisposeListener(IDisposeListener listener)Adds the given dispose listener to the list of dispose listeners.protected voidaddListener(Object listenerType, IObservablesListener listener)voidaddStaleListener(IStaleListener listener)Adds the given stale listener to the list of stale listeners.protected voidcheckRealm()Asserts that the realm is the current realm.protected Objectclone()voiddispose()Disposes of this observable object, removing all listeners registered with this object, and all listeners this object might have registered on other objects.protected voidfireChange()protected voidfireEvent(ObservableEvent event)protected voidfireStale()protected voidfirstListenerAdded()RealmgetRealm()protected booleanhasListeners()booleanisDisposed()Returns whether the observable has been disposedprotected voidlastListenerRemoved()voidremoveChangeListener(IChangeListener listener)Removes the given change listener from the list of change listeners.voidremoveDisposeListener(IDisposeListener listener)Removes the given dispose listener from the list of dispose listeners.protected voidremoveListener(Object listenerType, IObservablesListener listener)voidremoveStaleListener(IStaleListener listener)Removes the given stale listener from the list of stale listeners.-
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
getRealm, isStale
-
-
-
-
Constructor Detail
-
AbstractObservable
public AbstractObservable(Realm realm)
- Parameters:
realm-
-
-
Method Detail
-
addChangeListener
public void addChangeListener(IChangeListener listener)
Description copied from interface:IObservableAdds the given change listener to the list of change listeners. Change listeners are notified about changes of the state of this observable in a generic way, without specifying the change that happened. To get the changed state, a change listener needs to query for the current state of this observable.- Specified by:
addChangeListenerin interfaceIObservable
-
removeChangeListener
public void removeChangeListener(IChangeListener listener)
Description copied from interface:IObservableRemoves the given change listener from the list of change listeners. Has no effect if the given listener is not registered as a change listener.- Specified by:
removeChangeListenerin interfaceIObservable
-
addStaleListener
public void addStaleListener(IStaleListener listener)
Description copied from interface:IObservableAdds the given stale listener to the list of stale listeners. Stale listeners are notified when an observable object becomes stale, not when is becomes non-stale.- Specified by:
addStaleListenerin interfaceIObservable- See Also:
IObservable.isStale()
-
removeStaleListener
public void removeStaleListener(IStaleListener listener)
Description copied from interface:IObservableRemoves the given stale listener from the list of stale listeners. Has no effect if the given listener is not registered as a stale listener.- Specified by:
removeStaleListenerin interfaceIObservable
-
addDisposeListener
public void addDisposeListener(IDisposeListener listener)
Description copied from interface:IObservableAdds the given dispose listener to the list of dispose listeners. Dispose listeners are notified when an observable has been disposed.- Specified by:
addDisposeListenerin interfaceIObservable- Parameters:
listener- the listener to add- Since:
- 1.2
-
removeDisposeListener
public void removeDisposeListener(IDisposeListener listener)
Description copied from interface:IObservableRemoves the given dispose listener from the list of dispose listeners. Has no effect if the given listener is not registered as a dispose listener.- Specified by:
removeDisposeListenerin interfaceIObservable- Parameters:
listener- the listener to remove- Since:
- 1.2
-
fireChange
protected void fireChange()
-
fireStale
protected void fireStale()
-
isDisposed
public boolean isDisposed()
Description copied from interface:IObservableReturns whether the observable has been disposed- Specified by:
isDisposedin interfaceIObservable- Returns:
- whether the observable has been disposed
- Since:
- 1.2
-
dispose
public void dispose()
Description copied from interface:IObservableDisposes of this observable object, removing all listeners registered with this object, and all listeners this object might have registered on other objects.- Specified by:
disposein interfaceIObservable
-
checkRealm
protected void checkRealm()
Asserts that the realm is the current realm.- Throws:
AssertionFailedException- if the realm is not the current realm- See Also:
Realm.isCurrent()
-
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
-
-