|
Oracle® Coherence Java API Reference Release 12.1.2.0.3 E26043-02 |
|||||||
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
com.tangosol.net.cache.CacheEvent
public class CacheEvent
An extension of the MapEvent which allows to differentiate between client driven (natural) events and cache internal (synthetic) events.
Consider a client code calling a remove() method for a cache. Quite naturally it causes a corresponding ENTRY_DELETED event. However, the same event could be as well caused by the client code calling put() forcing an entry eviction. Alternatively, the put() method called by a client code naturally causes either ENTRY_INSERTED or ENTRY_UPDATED event. However, the same event could be as well caused by a client call to a get() method that in turn forces an entry insertion by a cache loader.
Nested Class Summary | |
---|---|
static class |
CacheEvent.TransformationState TransformationState describes how a CacheEvent has been or should be transformed . |
Field Summary | |
---|---|
protected boolean |
m_fSynthetic Flag indicating whether or not the event is synthetic. |
protected CacheEvent.TransformationState |
m_transformState The transformation state for this event. |
Fields inherited from class com.tangosol.util.MapEvent |
---|
ENTRY_DELETED, ENTRY_INSERTED, ENTRY_UPDATED, m_nId, m_oKey, m_oValueNew, m_oValueOld |
Fields inherited from class java.util.EventObject |
---|
source |
Constructor Summary | |
---|---|
CacheEvent(ObservableMap map, int nId, java.lang.Object oKey, java.lang.Object oValueOld, java.lang.Object oValueNew, boolean fSynthetic) Constructs a new CacheEvent. |
|
CacheEvent(ObservableMap map, int nId, java.lang.Object oKey, java.lang.Object oValueOld, java.lang.Object oValueNew, boolean fSynthetic, CacheEvent.TransformationState transformState) Constructs a new CacheEvent. |
Method Summary | |
---|---|
protected java.lang.String |
getDescription() Get the event's description. |
CacheEvent.TransformationState |
getTransformationState() Return true iff this event is transformable . |
boolean |
isSynthetic() Return true iff this event is caused by the cache internal processing such as eviction or loading |
Methods inherited from class com.tangosol.util.MapEvent |
---|
dispatch, dispatch, dispatch, getDescription, getId, getKey, getMap, getNewEntry, getNewValue, getOldEntry, getOldValue, toString |
Methods inherited from class java.util.EventObject |
---|
getSource |
Field Detail |
---|
protected boolean m_fSynthetic
protected CacheEvent.TransformationState m_transformState
Constructor Detail |
---|
public CacheEvent(ObservableMap map, int nId, java.lang.Object oKey, java.lang.Object oValueOld, java.lang.Object oValueNew, boolean fSynthetic)
map
- the ObservableMap object that fired the eventnId
- this event's id, one of MapEvent.ENTRY_INSERTED
, MapEvent.ENTRY_UPDATED
or MapEvent.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)fSynthetic
- true iff the event is caused by the cache internal processing such as eviction or loadingpublic CacheEvent(ObservableMap map, int nId, java.lang.Object oKey, java.lang.Object oValueOld, java.lang.Object oValueNew, boolean fSynthetic, CacheEvent.TransformationState transformState)
map
- the ObservableMap object that fired the eventnId
- this event's id, one of MapEvent.ENTRY_INSERTED
, MapEvent.ENTRY_UPDATED
or MapEvent.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)fSynthetic
- true iff the event is caused by the cache internal processing such as eviction or loadingtransformState
- the state
describing how this event has been or should be transformedMethod Detail |
---|
public boolean isSynthetic()
public CacheEvent.TransformationState getTransformationState()
transformable
. Non-transformable events will not be delivered to MapEventTransformer listeners.protected java.lang.String getDescription()
getDescription
in class MapEvent
|
Oracle® Coherence Java API Reference Release 12.1.2.0.3 E26043-02 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |