Skip navigation links

Oracle® Coherence Java API Reference
v3.5.1

E15583-01


com.tangosol.net.cache
Class CacheEvent

java.lang.Object
  extended by java.util.EventObject
      extended by com.tangosol.util.MapEvent
          extended by com.tangosol.net.cache.CacheEvent

All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
ConverterCollections.ConverterCacheEvent, MapListenerSupport.FilterEvent, OverflowMap.HistoricCacheEvent

public class CacheEvent
extends MapEvent

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.

Since:
Coherence 2.3
Author:
gg 2003.09.12

Field Summary
protected  boolean m_fSynthetic
          Event cause flag.

 

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.

 

Method Summary
protected  java.lang.String getDescription()
          Get the event's description.
 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, getNewValue, getOldValue, toString

 

Methods inherited from class java.util.EventObject
getSource

 

Field Detail

m_fSynthetic

protected boolean m_fSynthetic
Event cause flag.

Constructor Detail

CacheEvent

public CacheEvent(ObservableMap map,
                  int nId,
                  java.lang.Object oKey,
                  java.lang.Object oValueOld,
                  java.lang.Object oValueNew,
                  boolean fSynthetic)
Constructs a new CacheEvent.
Parameters:
map - the ObservableMap object that fired the event
nId - this event's id, one of MapEvent.ENTRY_INSERTED, MapEvent.ENTRY_UPDATED or MapEvent.ENTRY_DELETED
oKey - the key into the map
oValueOld - 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 loading

Method Detail

isSynthetic

public boolean isSynthetic()
Return true iff this event is caused by the cache internal processing such as eviction or loading
Returns:
true iff this event is caused by the cache internal processing

getDescription

protected java.lang.String getDescription()
Get the event's description.
Overrides:
getDescription in class MapEvent
Returns:
this event's description

Skip navigation links

Oracle® Coherence Java API Reference
v3.5.1

E15583-01


Copyright © 2000, 2009, Oracle. All rights reserved.