IInvocableCache Interface |
14c (14.1.1.0)
F23534-02
An IInvocableCache is an ICache against which both
entry-targeted processing and aggregating operations can be invoked.
Namespace: Tangosol.Net.Cache
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
SyntaxC#
public interface IInvocableCache : ICache, IDictionary, ICollection, IEnumerable
The IInvocableCache type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | Count | Gets the number of elements contained in the ICollection. (Inherited from ICollection.) |
| Entries |
Gets a collection of ICacheEntry instances
within the cache.
(Inherited from ICache.) |
| IsFixedSize | Gets a value indicating whether the IDictionary object has a fixed size. (Inherited from IDictionary.) |
| IsReadOnly | Gets a value indicating whether the IDictionary object is read-only. (Inherited from IDictionary.) |
| IsSynchronized | Gets a value indicating whether access to the ICollection is synchronized (thread safe). (Inherited from ICollection.) |
| Item | Gets or sets the element with the specified key. (Inherited from IDictionary.) |
| Keys | Gets an ICollection object containing the keys of the IDictionary object. (Inherited from IDictionary.) |
| SyncRoot | Gets an object that can be used to synchronize access to the ICollection. (Inherited from ICollection.) |
| Values | Gets an ICollection object containing the values in the IDictionary object. (Inherited from IDictionary.) |
Methods| Name | Description | |
|---|---|---|
 | Add | Adds an element with the provided key and value to the IDictionary object. (Inherited from IDictionary.) |
| Aggregate(ICollection, IEntryAggregator) |
Perform an aggregating operation against the entries specified by
the passed keys.
|
| Aggregate(IFilter, IEntryAggregator) |
Perform an aggregating operation against the collection of
entries that are selected by the given IFilter.
|
| Clear | Removes all elements from the IDictionary object. (Inherited from IDictionary.) |
| Contains | Determines whether the IDictionary object contains an element with the specified key. (Inherited from IDictionary.) |
| CopyTo | (Inherited from ICollection.) |
| GetAll |
Get the values for all the specified keys, if they are in the
cache.
(Inherited from ICache.) |
| GetEnumerator |
Returns an ICacheEnumerator object for the
ICache instance.
(Inherited from ICache.) |
| Insert(Object, Object) |
Associates the specified value with the specified key in this
cache.
(Inherited from ICache.) |
| Insert(Object, Object, Int64) |
Associates the specified value with the specified key in this
cache.
(Inherited from ICache.) |
| InsertAll |
Copies all of the mappings from the specified dictionary to this
cache (optional operation).
(Inherited from ICache.) |
| Invoke |
Invoke the passed IEntryProcessor against the entry
specified by the passed key, returning the result of the
invocation.
|
| InvokeAll(ICollection, IEntryProcessor) |
Invoke the passed IEntryProcessor against the
entries specified by the passed keys, returning the result of the
invocation for each.
|
| InvokeAll(IFilter, IEntryProcessor) |
Invoke the passed IEntryProcessor against the set
of entries that are selected by the given IFilter,
returning the result of the invocation for each.
|
| Remove | Removes the element with the specified key from the IDictionary object. (Inherited from IDictionary.) |
Extension Methods| Name | Description | |
|---|---|---|
 | GetOrDefault |
Returns the value to which the specified key is mapped, or
the defaultValue if this cache contains no mapping for the key.
(Defined by InvocableCacheEx.) |
| InsertIfAbsent |
If the specified key is not already associated with a value
(or is mapped to null) associates it with the given value and
returns null, else returns the current value.
(Defined by InvocableCacheEx.) |
| Remove |
Removes the entry for the specified key only if it is currently
mapped to the specified value.
(Defined by InvocableCacheEx.) |
| Replace(Object, Object) | Overloaded.
Replaces the entry for the specified key only if it is
currently mapped to some value.
(Defined by InvocableCacheEx.) |
| Replace(Object, Object, Object) | Overloaded.
Replaces the entry for the specified key only if currently
mapped to the specified value.
(Defined by InvocableCacheEx.) |
RemarksWhile a traditional model for working with a dictionary is to have an operation access and mutate the dictionary directly through its API, the IInvocableCache allows that model of operation to be inverted such that the operations against the cache contents are executed by (and thus within the localized context of) a cache. This is particularly useful in a distributed environment, because it enables the processing to be moved to the location at which the entries-to-be-processed are being managed, thus providing efficiency by localization of processing.
See Also