|
Oracle® Coherence Java API Reference Release 3.6.0.0 E15725-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
java.util.EventObject
com.tangosol.util.MapEvent
public class MapEvent
An event which indicates that the content of a map has changed:
A MapEvent object is sent as an argument to the MapListener interface methods. Null values may be provided for the old and the new values.
Field Summary | |
---|---|
static int |
ENTRY_DELETED This event indicates that an entry has been removed from the map. |
static int |
ENTRY_INSERTED This event indicates that an entry has been added to the map. |
static int |
ENTRY_UPDATED This event indicates that an entry has been updated in the map. |
protected int |
m_nId The event's id. |
protected Object |
m_oKey A key. |
protected Object |
m_oValueNew A new value. |
protected Object |
m_oValueOld A previous value. |
Fields inherited from class java.util.EventObject |
---|
source |
Constructor Summary | |
---|---|
MapEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew) Constructs a new MapEvent. |
Method Summary | |
---|---|
void |
dispatch(Listeners listeners) Dispatch this event to the specified listeners collection. |
void |
dispatch(Listeners listeners, boolean fStrict) Dispatch this event to the specified listeners collection. |
void |
dispatch(MapListener listener) Dispatch this event to the specified MapListener. |
protected String |
getDescription() Get the event's description. |
static String |
getDescription(int nId) Convert an event ID into a human-readable string. |
int |
getId() Return this event's id. |
Object |
getKey() Return a key associated with this event. |
ObservableMap |
getMap() Return an ObservableMap object on which this event has actually occured. |
Map.Entry |
getNewEntry() Return a Map Entry that represents the state of the Entry after the change occurred that generated this event. |
Object |
getNewValue() Return a new value associated with this event. |
Map.Entry |
getOldEntry() Return a Map Entry that represents the state of the Entry before the change occurred that generated this event. |
Object |
getOldValue() Return an old value associated with this event. |
String |
toString() Return a String representation of this MapEvent object. |
Methods inherited from class java.util.EventObject |
---|
getSource |
Field Detail |
---|
public static final int ENTRY_INSERTED
public static final int ENTRY_UPDATED
public static final int ENTRY_DELETED
protected int m_nId
protected Object m_oKey
protected Object m_oValueOld
protected Object m_oValueNew
Constructor Detail |
---|
public MapEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew)
map
- the ObservableMap object that fired the eventnId
- this event's id, one of ENTRY_INSERTED
, ENTRY_UPDATED
or ENTRY_DELETED
oKey
- the key into the mapoValueOld
- the old value (for update and delete events)oValueNew
- the new value (for insert and update events)Method Detail |
---|
public ObservableMap getMap()
public int getId()
public Object getKey()
public Object getOldValue()
The old value represents a value deleted from or updated in a map. It is always null for "insert" notifications.
public Object getNewValue()
The new value represents a new value inserted into or updated in a map. It is always null for "delete" notifications.
public Map.Entry getOldEntry()
public Map.Entry getNewEntry()
public String toString()
toString
in class EventObject
public void dispatch(Listeners listeners)
This call is equivalent to
dispatch(listeners, true);
listeners
- the listeners collectionClassCastException
- if any of the targets is not an instance of MapListener interfacepublic void dispatch(Listeners listeners, boolean fStrict)
listeners
- the listeners collectionfStrict
- if true then any RuntimeException thrown by event handlers stops all further event processing and the exception is re-thrown; if false then all exceptions are logged and the process continuesClassCastException
- if any of the targets is not an instance of MapListener interfacepublic void dispatch(MapListener listener)
listener
- the listenerprotected String getDescription()
public static String getDescription(int nId)
nId
- an event ID, one of the ENTRY_* enumerated values
|
Oracle® Coherence Java API Reference Release 3.6.0.0 E15725-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |