Click or drag to resize

ConditionalPut Class

Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02
ConditionalPut is an IEntryProcessor that sets Valueif 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 ConditionalPut : AbstractProcessor, 
	IPortableObject

The ConditionalPut type exposes the following members.

Constructors
  NameDescription
Public methodConditionalPut
Default constructor.
Public methodConditionalPut(IFilter, Object)
Construct a ConditionalPut that updates an entry with a new value if and only if the filter applied to the entry evaluates to true.
Public methodConditionalPut(IFilter, Object, Boolean)
Construct a ConditionalPut that updates an entry with a new value if and only if the filter applied to the entry evaluates to true.
Top
Methods
  NameDescription
Public methodEquals
Compare the ConditionalPut 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 ConditionalPut 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 ConditionalPut.
(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.
Protected fieldm_value
Specifies the new value to update an entry with.
Top
Remarks

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

IInvocableCacheIConcurrentCache
filter = PresentFilter.Instance;
            cache.Invoke(key, new ConditionalPut(filter, value));cache.Replace(key, value);
filter = new NotFilter(PresentFilter.Instance);
            cache.Invoke(key, new ConditionalPut(filter, value));cache.PutIfAbsent(key, value);
filter = new EqualsFilter(IdentityExtractor.Instance, valueOld);
            cache.Invoke(key, new ConditionalPut(filter, valueNew));cache.Replace(key, valueOld, valueNew);

Obviously, using more specific, fine-tuned filters (rather than ones based on the IdentityExtractor may provide additional flexibility and efficiency allowing the put operation to be performed conditionally on values of specific attributes (or even calculations) instead of the entire object.

See Also