public interface IObservable
Implementations must not manage listeners themselves, listener management
must be delegated to a private instance of type ChangeSupport
if it
is not inherited from AbstractObservable
.
Modifier and Type | Method and Description |
---|---|
void |
addChangeListener(IChangeListener listener)
Adds the given change listener to the list of change listeners.
|
void |
addDisposeListener(IDisposeListener listener)
Adds the given dispose listener to the list of dispose listeners.
|
void |
addStaleListener(IStaleListener listener)
Adds the given stale listener to the list of stale listeners.
|
void |
dispose()
Disposes of this observable object, removing all listeners registered
with this object, and all listeners this object might have registered on
other objects.
|
Realm |
getRealm()
Returns the realm for this observable.
|
boolean |
isDisposed()
Returns whether the observable has been disposed
|
boolean |
isStale()
Returns whether the state of this observable is stale and is expected to
change soon.
|
void |
removeChangeListener(IChangeListener listener)
Removes the given change listener from the list of change listeners.
|
void |
removeDisposeListener(IDisposeListener listener)
Removes the given dispose listener from the list of dispose listeners.
|
void |
removeStaleListener(IStaleListener listener)
Removes the given stale listener from the list of stale listeners.
|
Realm getRealm()
Because observables can only be accessed from within one realm, and they always fire events on that realm, their state can be observed in an incremental way. It is always safe to call getters of an observable from within a change listener attached to that observable.
void addChangeListener(IChangeListener listener)
listener
- void removeChangeListener(IChangeListener listener)
listener
- void addStaleListener(IStaleListener listener)
listener
- isStale()
void removeStaleListener(IStaleListener listener)
listener
- boolean isStale()
ObservableTracker.getterCalled(IObservable)
.void addDisposeListener(IDisposeListener listener)
listener
- the listener to addvoid removeDisposeListener(IDisposeListener listener)
listener
- the listener to removeboolean isDisposed()
void dispose()
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.