|
Eclipse Platform Release 3.3 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.AbstractMap
org.eclipse.core.databinding.observable.map.AbstractObservableMap
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.
Nested Class Summary |
---|
Nested classes inherited from class java.util.Map |
---|
Map.Entry |
Constructor Summary | |
---|---|
AbstractObservableMap()
|
|
AbstractObservableMap(Realm realm)
|
Method Summary | |
---|---|
void |
addChangeListener(IChangeListener listener)
Adds the given change listener to the list of change listeners. |
void |
addMapChangeListener(IMapChangeListener listener)
|
void |
addStaleListener(IStaleListener listener)
Adds the given stale listener to the list of stale listeners. |
protected void |
checkRealm()
Asserts that the realm is the current realm. |
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. |
protected void |
fireChange()
Fires change events. |
protected void |
fireMapChange(MapDiff diff)
Fires map change events. |
protected void |
fireStale()
Fires stale events. |
protected void |
firstListenerAdded()
|
Realm |
getRealm()
Returns the realm for this observable. |
boolean |
isStale()
Returns whether the state of this observable is stale and is expected to change soon. |
protected void |
lastListenerRemoved()
|
void |
removeChangeListener(IChangeListener listener)
Removes the given change listener from the list of change listeners. |
void |
removeMapChangeListener(IMapChangeListener listener)
|
void |
removeStaleListener(IStaleListener listener)
Removes the given stale listener from the list of stale listeners. |
void |
setStale(boolean stale)
Sets the stale state. |
Methods inherited from class java.util.AbstractMap |
---|
clear, clone, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, toString, values |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.eclipse.core.databinding.observable.map.IObservableMap |
---|
containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, remove, size, values |
Methods inherited from interface java.util.Map |
---|
clear, putAll |
Constructor Detail |
public AbstractObservableMap()
public AbstractObservableMap(Realm realm)
realm
- Method Detail |
protected void lastListenerRemoved()
protected void firstListenerAdded()
public void addMapChangeListener(IMapChangeListener listener)
addMapChangeListener
in interface IObservableMap
listener
- public void removeMapChangeListener(IMapChangeListener listener)
removeMapChangeListener
in interface IObservableMap
listener
- public void addChangeListener(IChangeListener listener)
IObservable
addChangeListener
in interface IObservable
listener
- public void addStaleListener(IStaleListener listener)
IObservable
addStaleListener
in interface IObservable
listener
- IObservable.isStale()
public void dispose()
IObservable
dispose
in interface IObservable
public Realm getRealm()
IObservable
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.
getRealm
in interface IObservable
public boolean isStale()
IObservable
isStale
in interface IObservable
public void removeChangeListener(IChangeListener listener)
IObservable
removeChangeListener
in interface IObservable
listener
- public void removeStaleListener(IStaleListener listener)
IObservable
removeStaleListener
in interface IObservable
listener
- public void setStale(boolean stale)
stale
- protected void fireStale()
protected void fireChange()
protected void fireMapChange(MapDiff diff)
diff
- protected void checkRealm()
AssertionFailedException
- if the realm is not the current realmRealm.isCurrent()
|
Eclipse Platform Release 3.3 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.