Package com.tangosol.net.cache

Class SeppukuMapListener

java.lang.Object

com.tangosol.util.Base

com.tangosol.net.cache.SeppukuMapListener

All Implemented Interfaces:

MapListener, EventListener

public class SeppukuMapListener
extends Base
implements MapListener

A map listener that follows the "seppuku" pattern, invalidating the Map entries when MapEvents for another related ObservableMap are delivered.

Author:

gg 2002.09.10

See Also:

"Seppuku pattern" by Dimitri Rakitine

Nested Class Summary

Nested classes/interfaces inherited from class com.tangosol.util.Base

Base.LoggingWriter

Field Summary

Fields inherited from class com.tangosol.util.Base

LOG_ALWAYS, LOG_CONFIG, LOG_DEBUG, LOG_ERR, LOG_INFO, LOG_MAX, LOG_MIN, LOG_QUIET, LOG_WARN, POWER_0, POWER_G, POWER_K, POWER_M, POWER_T, UNIT_D, UNIT_H, UNIT_M, UNIT_MS, UNIT_NS, UNIT_S, UNIT_US

Fields inherited from interface com.tangosol.util.MapListener

ASYNCHRONOUS, SYNCHRONOUS, VERSION_AWARE

Constructor Summary

Constructors

Constructor	Description
SeppukuMapListener(Map map)	Construct a SeppukuMapListener for the specified front map.

Method Summary

Modifier and Type	Method	Description
void	entryDeleted(MapEvent evt)	Invoked when a map entry has been removed.
void	entryInserted(MapEvent evt)	Invoked when a map entry has been inserted.
void	entryUpdated(MapEvent evt)	Invoked when a map entry has been updated.
Map	getMap()	Returns the front Map invalidated by this listener.
protected void	validate(Object oKey, Object oValue)	Validate the specified entry and remove it from the Map object affected by this listener if and only if the value is different (implying that the entry has been modified elsewhere).

Methods inherited from class com.tangosol.util.Base

azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getProcessRandom, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mergeArray, mergeBooleanArray, mergeByteArray, mergeCharArray, mergeDoubleArray, mergeFloatArray, mergeIntArray, mergeLongArray, mod, mod, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.tangosol.util.MapListener

characteristics, isAsynchronous, isSynchronous, isVersionAware, synchronous

Constructor Detail

SeppukuMapListener

public SeppukuMapListener(Map map)

Construct a SeppukuMapListener for the specified front map.

Parameters:

map - the Map object to modify based on events issued to this Listener from a different ObservableMap object

Method Detail

getMap

public Map getMap()

Returns the front Map invalidated by this listener.

Returns:

the front Map invalidated by this listener

entryInserted

public void entryInserted(MapEvent evt)

Invoked when a map entry has been inserted.

Specified by:

entryInserted in interface MapListener

Parameters:

evt - the MapEvent

entryUpdated

public void entryUpdated(MapEvent evt)

Invoked when a map entry has been updated.

Specified by:

entryUpdated in interface MapListener

Parameters:

evt - the MapEvent

entryDeleted

public void entryDeleted(MapEvent evt)

Invoked when a map entry has been removed.

Specified by:

entryDeleted in interface MapListener

Parameters:

evt - the MapEvent

validate

protected void validate(Object oKey,
                        Object oValue)

Validate the specified entry and remove it from the Map object affected by this listener if and only if the value is different (implying that the entry has been modified elsewhere).

Parameters:

oKey - the entry key

oValue - the "new" entry value; this is potentially different from the one in the map maintained by this Suppuku listener