Package com.tangosol.util

Class MapListenerSupport.FilterEvent

java.lang.Object

java.util.EventObject

com.tangosol.util.MapEvent<K,V>

com.tangosol.net.cache.CacheEvent

com.tangosol.util.MapListenerSupport.FilterEvent

All Implemented Interfaces:

PortableObject, Serializable

Enclosing class:

MapListenerSupport

public static class MapListenerSupport.FilterEvent
extends CacheEvent

An extension of the CacheEvent which may carry no values (old or new), but instead holds on an array of Filter objects being the "cause" of the event.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.tangosol.net.cache.CacheEvent

CacheEvent.TransformationState

Field Summary

Fields

Modifier and Type	Field	Description
protected Filter[]	f_aFilter	Filters that caused the event.
protected MapEvent	f_event	Optional wrapped MapEvent.

Fields inherited from class com.tangosol.net.cache.CacheEvent

EXPIRED, m_nFlags, m_transformState, PRIMING, SYNTHETIC

Fields inherited from class com.tangosol.util.MapEvent

ENTRY_DELETED, ENTRY_INSERTED, ENTRY_UPDATED, m_key, m_nId, m_nPartition, m_nVersion, m_valueNew, m_valueOld

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor	Description
FilterEvent(MapEvent event, Filter[] aFilter)	Constructs a new FilterEvent that wraps the given MapEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, boolean fSynthetic, boolean fPriming, Filter[] aFilter)	Constructs a new lite (no values are specified) FilterEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, boolean fSynthetic, Filter[] aFilter)	Constructs a new lite (no values are specified) FilterEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew, boolean fSynthetic, boolean fPriming, Filter[] aFilter)	Constructs a new FilterEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew, boolean fSynthetic, CacheEvent.TransformationState transformState, boolean fPriming, boolean fExpired, Filter[] aFilter)	Constructs a new FilterEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew, boolean fSynthetic, CacheEvent.TransformationState transformState, boolean fPriming, Filter[] aFilter)	Constructs a new FilterEvent.
FilterEvent(ObservableMap map, int nId, Object oKey, Object oValueOld, Object oValueNew, boolean fSynthetic, CacheEvent.TransformationState transformState, Filter[] aFilter)	Constructs a new FilterEvent.

Method Summary

Modifier and Type	Method	Description
protected String	getDescription()	Get the event's description.
Filter[]	getFilter()	Return an array of filters that are the cause of this event.
Object	getKey()	Return a key associated with this event.
MapEvent	getMapEvent()	Return the wrapped event.
Object	getNewValue()	Return a new value associated with this event.
Object	getOldValue()	Return an old value associated with this event.

Methods inherited from class com.tangosol.net.cache.CacheEvent

getTransformationState, isExpired, isPriming, isSynthetic, isVersionUpdate, shouldDispatch, with

Methods inherited from class com.tangosol.util.MapEvent

dispatch, dispatch, dispatch, getDescription, getId, getMap, getNewEntry, getOldEntry, getPartition, getVersion, isDelete, isInsert, isUpdate, readExternal, toString, writeExternal

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Field Detail

f_aFilter

protected final Filter[] f_aFilter

Filters that caused the event.

f_event

protected final MapEvent f_event

Optional wrapped MapEvent.

Constructor Detail

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   boolean fSynthetic,
                   Filter[] aFilter)

Constructs a new lite (no values are specified) FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

aFilter - an array of filters that caused this event

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   boolean fSynthetic,
                   boolean fPriming,
                   Filter[] aFilter)

Constructs a new lite (no values are specified) FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

fPriming - a flag indicating whether or not the event is a priming event

aFilter - an array of filters that caused this event

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   Object oValueOld,
                   Object oValueNew,
                   boolean fSynthetic,
                   boolean fPriming,
                   Filter[] aFilter)

Constructs a new FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

oValueOld - the old value

oValueNew - the new value

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

fPriming - a flag indicating whether or not the event is a priming event

aFilter - an array of filters that caused this event

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   Object oValueOld,
                   Object oValueNew,
                   boolean fSynthetic,
                   CacheEvent.TransformationState transformState,
                   Filter[] aFilter)

Constructs a new FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

oValueOld - the old value

oValueNew - the new value

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

transformState - the state describing how this event has been or should be transformed

aFilter - an array of filters that caused this event

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   Object oValueOld,
                   Object oValueNew,
                   boolean fSynthetic,
                   CacheEvent.TransformationState transformState,
                   boolean fPriming,
                   Filter[] aFilter)

Constructs a new FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

oValueOld - the old value

oValueNew - the new value

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

transformState - the state describing how this event has been or should be transformed

fPriming - a flag indicating whether or not the event is a priming event

aFilter - an array of filters that caused this event

FilterEvent

public FilterEvent(ObservableMap map,
                   int nId,
                   Object oKey,
                   Object oValueOld,
                   Object oValueNew,
                   boolean fSynthetic,
                   CacheEvent.TransformationState transformState,
                   boolean fPriming,
                   boolean fExpired,
                   Filter[] aFilter)

Constructs a new FilterEvent.

Parameters:

map - the ObservableMap object that fired the event

nId - this event's id

oKey - the key into the map

oValueOld - the old value

oValueNew - the new value

fSynthetic - true iff the event is caused by the cache internal processing such as eviction or loading

transformState - the state describing how this event has been or should be transformed

fPriming - a flag indicating whether or not the event is a priming event

fExpired - true iff the event results from an eviction due to time

aFilter - an array of filters that caused this event

Since:

22.06

FilterEvent

public FilterEvent(MapEvent event,
                   Filter[] aFilter)

Constructs a new FilterEvent that wraps the given MapEvent.

Parameters:

event - the wrapped MapEvent

aFilter - an array of filters that caused this event

Method Detail

getFilter

public Filter[] getFilter()

Return an array of filters that are the cause of this event.

Returns:

an array of filters

getMapEvent

public MapEvent getMapEvent()

Return the wrapped event.

Returns:

the underlying MapEvent

Since:

12.2.1.4

getDescription

protected String getDescription()

Get the event's description.

Overrides:

getDescription in class CacheEvent

Returns:

this event's description

getKey

public Object getKey()

Return a key associated with this event.

Overrides:

getKey in class MapEvent

Returns:

a key

getOldValue

public Object getOldValue()

Return an old value associated with this event.

The old value represents a value deleted from or updated in a map. It is always null for "insert" notifications.

Overrides:

getOldValue in class MapEvent

Returns:

an old value

getNewValue

public Object getNewValue()

Return a new value associated with this event.

The new value represents a new value inserted into or updated in a map. It is always null for "delete" notifications.

Overrides:

getNewValue in class MapEvent

Returns:

a new value