Click or drag to resize

ConditionalRemove Class

Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02
ConditionalRemove is an IEntryProcessor that performs an Remove(Boolean) operation if the specified condition is satisfied.
Inheritance Hierarchy

Namespace:  Tangosol.Util.Processor
Assembly:  Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
Syntax
C#
Copy
public class ConditionalRemove : AbstractProcessor, 
	IPortableObject

The ConditionalRemove type exposes the following members.

Constructors
  NameDescription
Public methodConditionalRemove
Default constructor.
Public methodConditionalRemove(IFilter)
Construct a ConditionalRemove processor that removes an IInvocableCacheEntry if and only if the filter applied to the entry evaluates to true.
Public methodConditionalRemove(IFilter, Boolean)
Construct a ConditionalRemove processor that removes an IInvocableCacheEntry if and only if the filter applied to the entry evaluates to true.
Top
Methods
  NameDescription
Public methodEquals
Compare the ConditionalRemove with another object to determine equality.
(Overrides ObjectEquals(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 ConditionalRemove object according to the general 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 methodProcess
Process an IInvocableCacheEntry.
(Overrides AbstractProcessorProcess(IInvocableCacheEntry).)
Public methodProcessAll
Process a collection of IInvocableCacheEntry objects.
(Overrides AbstractProcessorProcessAll(ICollection).)
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 ConditionalRemove.
(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 underlying filter.
Protected fieldm_return
Specifies whether or not a return value is required.
Top
Remarks

While the ConditionalRemove processing could be implemented via direct key-based IQueryCache operations, it is more efficient and enforces concurrency control without explicit locking.

For example, the following operations are functionally similar, but the IInvocableDictionary versions (a) perform significantly better for partitioned caches; (b) provide all necessary concurrency control (which is ommited from the IQueryCache examples): 

IInvocableCacheIQueryCache
cache.invoke(key, new ConditionalRemove(filter));if (filter.Evaluate(cache[key]) cache.Remove(key);
cache.InvokeAll(colKeys, new ConditionalRemove(filter));foreach (object key in colKeys)
                if (filter.Evaluate(cache.[key])
                    cache.Remove(key);
cache.InvokeAll(filter1, new ConditionalRemove(filter2);foreach (object key in cache.GetKeys(filter1))
                if (filter2.Evaluate(cache[key])
                    cache.Remove(key);
cache.InvokeAll(filter, new
                            ConditionalRemove(AlwaysFilter.INSTANCE));ICollection colKeys = cache.GetKeys(filter);
                cache.Keys.RemoveAll(colKeys);
See Also