Class ConverterCollections.ConverterObservableCache
A Converter ObservableCache views an underlying IObservableCache through a set of key and value IConverters.
Inheritance
Inherited Members
Namespace: Tangosol.Util
Assembly: Coherence.dll
Syntax
[Serializable]
public class ConverterCollections.ConverterObservableCache : ConverterCollections.ConverterCache, IObservableCache, ICache, IDictionary, ICollection, IEnumerableConstructors
ConverterObservableCache(IObservableCache, IConverter, IConverter, IConverter, IConverter)
Constructor.
Declaration
public ConverterObservableCache(IObservableCache cache, IConverter convKeyUp, IConverter convKeyDown, IConverter convValUp, IConverter convValDown)Parameters
| Type | Name | Description |
|---|---|---|
| IObservableCache | cache | The underlying IObservableCache. |
| IConverter | convKeyUp | The IConverter to view the underlying cache's keys through. |
| IConverter | convKeyDown | The IConverter to use to pass keys down to the underlying cache. |
| IConverter | convValUp | The IConverter to view the underlying cache's values through. |
| IConverter | convValDown | The IConverter to use to pass values down to the underlying cache. |
Properties
ObservableCache
The underlying IObservableCache.
Declaration
public virtual IObservableCache ObservableCache { get; }Property Value
| Type | Description |
|---|---|
| IObservableCache | The underlying IObservableCache. |
Methods
AddCacheListener(ICacheListener)
Add a standard cache listener that will receive all events (inserts, updates, deletes) that occur against the cache, with the key, old-value and new-value included.
Declaration
public virtual void AddCacheListener(ICacheListener listener)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The ICacheListener to add. |
Remarks
This has the same result as the following call:
AddCacheListener(listener, (IFilter) null, false);
AddCacheListener(ICacheListener, object, bool)
Add a cache listener for a specific key.
Declaration
public virtual void AddCacheListener(ICacheListener listener, object key, bool isLite)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The ICacheListener to add. |
| object | key | The key that identifies the entry for which to raise events. |
| bool | isLite | true to indicate that the CacheEventArgs objects do not have to include the OldValue and NewValue property values in order to allow optimizations. |
Remarks
The listeners will receive CacheEventArgs
objects, but if isLite is passed as
true, they might not contain the
OldValue and
NewValue properties.
To unregister the ICacheListener, use the RemoveCacheListener(ICacheListener, object) method.
AddCacheListener(ICacheListener, IFilter, bool)
Add a cache listener that receives events based on a filter evaluation.
Declaration
public virtual void AddCacheListener(ICacheListener listener, IFilter filter, bool isLite)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The ICacheListener to add. |
| IFilter | filter | A filter that will be passed CacheEventArgs objects to
select from; a CacheEventArgs will be delivered to the
listener only if the filter evaluates to true for that
CacheEventArgs; |
| bool | isLite | true to indicate that the CacheEventArgs objects do not have to include the OldValue and NewValue property values in order to allow optimizations. |
Remarks
The listeners will receive CacheEventArgs
objects, but if isLite is passed as
true, they might not contain the
OldValue and NewValue properties.
To unregister the ICacheListener, use the RemoveCacheListener(ICacheListener, IFilter) method.
GetConverterListener(ICacheListener)
Create a converter listener for the specified listener.
Declaration
protected virtual ICacheListener GetConverterListener(ICacheListener listener)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The underlying ICacheListener. |
Returns
| Type | Description |
|---|---|
| ICacheListener | The converting listener. |
RemoveCacheListener(ICacheListener)
Remove a standard cache listener that previously signed up for all events.
Declaration
public virtual void RemoveCacheListener(ICacheListener listener)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The ICacheListener to remove. |
Remarks
This has the same result as the following call:
RemoveCacheListener(listener, (IFilter) null);
RemoveCacheListener(ICacheListener, object)
Remove a cache listener that previously signed up for events about a specific key.
Declaration
public virtual void RemoveCacheListener(ICacheListener listener, object key)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The listener to remove. |
| object | key | The key that identifies the entry for which to raise events. |
RemoveCacheListener(ICacheListener, IFilter)
Remove a cache listener that previously signed up for events based on a filter evaluation.
Declaration
public virtual void RemoveCacheListener(ICacheListener listener, IFilter filter)Parameters
| Type | Name | Description |
|---|---|---|
| ICacheListener | listener | The ICacheListener to remove. |
| IFilter | filter | A filter used to evaluate events; |