Click or drag to resize

CacheEventFilter Class

Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02
IFilter which evaluates the content of a CacheEventArgs object according to the specified criteria.
Inheritance Hierarchy
SystemObject
  Tangosol.Util.FilterCacheEventFilter

Namespace:  Tangosol.Util.Filter
Assembly:  Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
Syntax
C#
Copy
public class CacheEventFilter : IFilter, 
	IPortableObject

The CacheEventFilter type exposes the following members.

Constructors
  NameDescription
Public methodCacheEventFilter
Default constructor.
Public methodCacheEventFilter(CacheEventFilterCacheEventMask)
Construct a CacheEventFilter that evaluates CacheEventArgs objects based on the specified combination of event types.
Public methodCacheEventFilter(IFilter)
Construct a CacheEventFilter that evaluates CacheEventArgs objects that would affect the results of a keys collection filter issued by a previous call to Keys.
Public methodCacheEventFilter(CacheEventFilterCacheEventMask, CacheEventFilterCacheEventSyntheticMask)
Construct a CacheEventFilter that evaluates CacheEventArgs objects based on the specified combination of event types.
Public methodCacheEventFilter(CacheEventFilterCacheEventMask, IFilter)
Construct a CacheEventFilter that evaluates CacheEventArgs objects based on the specified combination of event types.
Public methodCacheEventFilter(CacheEventFilterCacheEventMask, IFilter, CacheEventFilterCacheEventSyntheticMask)
Construct a CacheEventFilter that evaluates CacheEventArgs objects based on the specified combination of event types.
Top
Properties
  NameDescription
Public propertyEventMask
Obtain the event mask.
Public propertyFilter
Obtain the IFilter object used to evaluate the event value(s).
Top
Methods
  NameDescription
Public methodEquals
Compare the CacheEventFilter with another object to determine equality.
(Overrides ObjectEquals(Object).)
Public methodEvaluate
Apply the test to the object.
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Determine a hash value for the CacheEventFilter object according to the general object.GetHashCode() contract.
(Overrides ObjectGetHashCode.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodReadExternal
Restore the contents of a user type instance by reading its state using the specified IPofReader object.
Public methodToString
Return a human-readable description for this CacheEventFilter.
(Overrides ObjectToString.)
Public methodWriteExternal
Save the contents of a POF user type instance by writing its state using the specified IPofWriter object.
Top
Fields
  NameDescription
Protected fieldm_filter
The event value(s) filter.
Protected fieldm_mask
The event mask.
Protected fieldm_maskSynth
The synthetic mask.
Top
Remarks
This filter is intended to be used by various IObservableCache listeners that are interested in particular subsets of CacheEvent notifications emitted by the cache.

Usage examples:

  • a filter that evaluates to true if an Employee object is inserted into a cache with a value of IsMarried property set to true.
    Copy
    new CacheEventFilter(CacheEventMask.Inserted,
new EqualsFilter("IsMarried", true));
  • a filter that evaluates to true if any object is removed from a cache.
    Copy
    new CacheEventFilter(CacheEventMask.Deleted);
  • a filter that evaluates to true if there is an update to an Employee object where either an old or new value of LastName property equals to "Smith".
    Copy
    new CacheEventFilter(CacheEventMask.Updated,
new EqualsFilter("LastName", "Smith"));
  • a filter that is used to keep a cached keys collection result based on some cache filter up-to-date.
    Copy
    ICollection keys = new ArrayList();
IFilter filterEvt = new CacheEventFilter(filterCache);
ICacheListener listener = new TestListener();
cache.AddCacheListener(listener, filterEvt, true);
keys.AddAll(cache.GetKeys(filterCache));

See Also