| ICqListener Interface |
Note: This API is now obsolete.
An application plug-in that can be installed on a region.
Listener change notifications are invoked after
the change has occured.
Namespace: GemStone.GemFire.Cache
Assembly: Gemstone.Gemfire.Cache (in Gemstone.Gemfire.Cache.dll) Version: 9.0.6.18
SyntaxThe ICqListener type exposes the following members.
Methods| Name | Description | |
|---|---|---|
 | Close |
Called when the region containing this callback is destroyed, when
the cache is closed.
|
| OnError |
Handles the event of an entry's value being modified in a region.
|
| OnEvent |
Handles the event of a new key being added to a region.
|
Remarks
Listeners receive notifications when entries in a region change or changes occur to the
region attributes themselves.
A cache listener is defined in the [!:RegionAttributes].
The methods on a ICacheListener are invoked asynchronously. Multiple events can cause concurrent invocation of ICacheListener methods. If event A occurs before event B, there is no guarantee that their corresponding ICacheListener method invocations will occur in the same order. Any exceptions thrown by the listener are caught by GemFire and logged. Listeners are user callbacks that are invoked by GemFire. It is important to ensure that minimal work is done in the listener before returning control back to GemFire. For example, a listener implementation may choose to hand off the event to a thread pool that then processes the event on its thread rather than the listener threadSee AlsoReference
[!:AttributesFactory.SetCacheListener]
[!:RegionAttributes.CacheListener]
[!:ICacheLoader]
[!:ICacheWriter]