/// <summary>
/// Add a cache listener for a specific key.
/// </summary>
/// <remarks>
/// <p>
/// The listeners will receive <see cref="CacheEventArgs"/> objects,
/// but if <paramref name="isLite"/> is passed as <b>true</b>, they
/// <i>might</i> not contain the
/// <see cref="CacheEventArgs.OldValue"/> and
/// <see cref="CacheEventArgs.NewValue"/> properties.</p>
/// <p>
/// To unregister the ICacheListener, use the
/// <see cref="IObservableCache.RemoveCacheListener(ICacheListener,object)"/>
/// method.</p>
/// </remarks>
/// <param name="listener">
/// The <see cref="ICacheListener"/> to add.
/// </param>
/// <param name="key">
/// The key that identifies the entry for which to raise events.
/// </param>
/// <param name="isLite">
/// <b>true</b> to indicate that the <see cref="CacheEventArgs"/>
/// objects do not have to include the <b>OldValue</b> and
/// <b>NewValue</b> property values in order to allow optimizations.
/// </param>
public virtual void AddCacheListener(ICacheListener listener, object key, bool isLite)
{
LocalCache.AddCacheListener(listener, key, isLite);
}
/// <summary>
/// Add a cache listener that receives events based on a filter
/// evaluation.
/// </summary>
/// <remarks>
/// <p>
/// The listeners will receive <see cref="CacheEventArgs"/> objects,
/// but if <paramref name="isLite"/> is passed as <b>true</b>, they
/// <i>might</i> not contain the <b>OldValue</b> and <b>NewValue</b>
/// properties.</p>
/// <p>
/// To unregister the <see cref="ICacheListener"/>, use the
/// <see cref="IObservableCache.RemoveCacheListener(ICacheListener,IFilter)"/>
/// method.</p>
/// </remarks>
/// <param name="listener">
/// The <see cref="ICacheListener"/> to add.</param>
/// <param name="filter">
/// A filter that will be passed <b>CacheEventArgs</b> objects to
/// select from; a <b>CacheEventArgs</b> will be delivered to the
/// listener only if the filter evaluates to <b>true</b> for that
/// <b>CacheEventArgs</b>; <c>null</c> is equivalent to a filter
/// that alway returns <b>true</b>.
/// </param>
/// <param name="isLite">
/// <b>true</b> to indicate that the <see cref="CacheEventArgs"/>
/// objects do not have to include the <b>OldValue</b> and
/// <b>NewValue</b> property values in order to allow optimizations.
/// </param>
public virtual void AddCacheListener(ICacheListener listener, IFilter filter, bool isLite)
{
LocalCache.AddCacheListener(listener, filter, isLite);
}
/// <summary>
/// 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.
/// </summary>
/// <remarks>
/// This has the same result as the following call:
/// <pre>
/// AddCacheListener(listener, (IFilter) null, false);
/// </pre>
/// </remarks>
/// <param name="listener">
/// The <see cref="ICacheListener"/> to add.
/// </param>
public virtual void AddCacheListener(ICacheListener listener)
{
LocalCache.AddCacheListener(listener);
}
