Class AbstractObservable
java.lang.Object
org.eclipse.core.databinding.observable.AbstractObservable
- All Implemented Interfaces:
IObservable
- Direct Known Subclasses:
AbstractObservableSet,AbstractObservableValue,DecoratingObservable,ObservableList,ObservableMap,ObservableSet
- Since:
- 1.0
- Implementation Note:
- If methods are added to the interface which this class implements then implementations of those methods must be added to this class.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddChangeListener(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 voidAsserts 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 voidprotected voidfireEvent(ObservableEvent event) protected voidprotected voidgetRealm()protected booleanbooleanReturns whether the observable has been disposedprotected voidvoidremoveChangeListener(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, waitMethods inherited from interface org.eclipse.core.databinding.observable.IObservable
getRealm, isStale
-
Constructor Details
-
AbstractObservable
- Parameters:
realm- the realm to use; notnull
-
-
Method Details
-
addChangeListener
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- Parameters:
listener- the listener to add; notnull
-
removeChangeListener
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- Parameters:
listener- the listener to remove; notnull
-
addStaleListener
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- Parameters:
listener- the listener to add; notnull- See Also:
-
removeStaleListener
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- Parameters:
listener- the listener to remove; notnull
-
addDisposeListener
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
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:
-
addListener
- Parameters:
listenerType- arbitrary object to identify a type of the listenerlistener- the listener to add; notnull
-
removeListener
- Parameters:
listenerType- arbitrary object to identify a type of the listenerlistener- the listener to remove; notnull
-
hasListeners
protected boolean hasListeners() -
fireEvent
-
firstListenerAdded
protected void firstListenerAdded() -
lastListenerRemoved
protected void lastListenerRemoved() -
getRealm
- Returns:
- Returns the realm.
-
clone
- Overrides:
clonein classObject- Throws:
CloneNotSupportedException
-