Apache Geode CHANGELOG

List of Event Handlers and Events

Geode provides many types of events and event handlers to help you manage your different data and application needs.

Event Handlers

Use either cache handlers or membership handlers in any single application. Do not use both. The event handlers in this table are cache handlers unless otherwise noted.

Handler API	Events received	Description
`AsyncEventListener`	`AsyncEvent`	Tracks changes in a region for write-behind processing. Extends the `CacheCallback` interface. You install a write-back cache listener to an `AsyncEventQueue` instance. You can then add the `AsyncEventQueue` instance to one or more regions for write-behind processing. See Implementing an AsyncEventListener for Write-Behind Cache Event Handling.
`CacheCallback`		Superinterface of all cache event listeners. Functions only to clean up resources that the callback allocated.
`CacheListener`	`RegionEvent`, `EntryEvent`	Tracks changes to region and its data entries. Responds synchronously. Extends `CacheCallback` interface. Installed in region. Receives only local cache events. Install one in every member where you want the events handled by this listener. In a partitioned region, the cache listener only fires in the primary data store. Listeners on secondaries are not fired.
`CacheWriter`	`RegionEvent`, `EntryEvent`	Receives events for pending changes to the region and its data entries in this member or one of its peers. Has the ability to cancel the operations in question. Extends `CacheCallback` interface. Installed in region. Receives events from anywhere in the distributed region, so you can install one in one member for the entire distributed region. Receives events only in primary data store in partitioned regions, so install one in every data store.
`ClientMembershipListener`	`ClientMembershipEvent`	One of the interfaces that replaces the deprecated Admin APIs. You can use the ClientMembershipListener to receive membership events only about clients. This listener’s callback methods are invoked when this process detects connection changes to clients. Callback methods include `memberCrashed`, `memberJoined`, `memberLeft` (graceful exit).
`CqListener`	`CqEvent`	Receives events from the server cache that satisfy a client-specified query. Extends `CacheCallback` interface. Installed in the client inside a `CqQuery`.
`GatewayConflictResolver`	`TimestampedEntryEvent`	Decides whether to apply a potentially conflicting event to a region that is distributed over a WAN configuration. This event handler is called only when the distributed system ID of an update event is different from the ID that last updated the region entry.
`MembershipListener`	`MembershipEvent`	Use this interface to receive membership events only about peers. This listener’s callback methods are invoked when peer members join or leave the cluster. Callback methods include `memberCrashed`, `memberJoined`, and `memberLeft` (graceful exit).
`RegionMembershipListener`	`RegionEvent`	Provides after-event notification when a region with the same name has been created in another member and when other members hosting the region join or leave the cluster. Extends `CacheCallback` and `CacheListener`. Installed in region as a `CacheListener`.
`TransactionListener`	`TransactionEvent` with embedded list of `EntryEvent`	Tracks the outcome of transactions and changes to data entries in the transaction. Note: Multiple transactions on the same cache can cause concurrent invocation of `TransactionListener` methods, so implement methods that do the appropriate synchronizing of the multiple threads for thread-safe operation. Extends `CacheCallback` interface. Installed in cache using transaction manager. Works with region-level listeners if needed.
`TransactionWriter`	`TransactionEvent` with embedded list of `EntryEvent`	Receives events for pending transaction commits. Has the ability to cancel the transaction. Extends `CacheCallback` interface. Installed in cache using transaction manager. At most one writer is called per transaction. Install a writer in every transaction host.
`UniversalMembershipListenerAdapter`	`MembershipEvent` and `ClientMembershipEvent`	One of the interfaces that replaces the deprecated Admin APIs. Provides a wrapper for MembershipListener and ClientMembershipListener callbacks for both clients and peers.

Events

The events in this table are cache events unless otherwise noted.

Event	Passed to handler …	Description
`AsyncEvent`	`AsyncEventListener`	Provides information about a single event in the cache for asynchronous, write-behind processing.
`CacheEvent`		Superinterface to `RegionEvent` and `EntryEvent`. This defines common event methods, and contains data needed to diagnose the circumstances of the event, including a description of the operation being performed, information about where the event originated, and any callback argument passed to the method that generated this event.
`ClientMembershipEvent`	`ClientMembershipListener`	An event delivered to a `ClientMembershipListener` when this process detects connection changes to servers or clients.
`CqEvent`	`CqListener`	Provides information about a change to the results of a continuous query running on a server on behalf of a client. `CqEvent`s are processed on the client.
`EntryEvent`	`CacheListener`, `CacheWriter`, `TransactionListener` (inside the `TransactionEvent`)	Extends `CacheEvent` for entry events. Contains information about an event affecting a data entry in the cache. The information includes the key, the value before this event, and the value after this event. `EntryEvent.getNewValue` returns the current value of the data entry. `EntryEvent.getOldValue` returns the value before this event if it is available. For a partitioned region, returns the old value if the local cache holds the primary copy of the entry. `EntryEvent` provides the Geode transaction ID if available. You can retrieve serialized values from `EntryEvent` using the `getSerialized`* methods. This is useful if you get values from one region’s events just to put them into a separate cache region. There is no counterpart `put` function as the put recognizes that the value is serialized and bypasses the serialization step.
`MembershipEvent` (membership event)	`MembershipListener`	An event that describes the member that originated this event. Instances of this are delivered to a `MembershipListener` when a member has joined or left the cluster.
`RegionEvent`	`CacheListener`, `CacheWriter`, `RegionMembershipListener`	Extends `CacheEvent` for region events. Provides information about operations that affect the whole region, such as reinitialization of the region after being destroyed.
`TimestampedEntryEvent`	`GatewayConflictResolver`	Extends `EntryEvent` to include a timestamp and distributed system ID associated with the event. The conflict resolver can compare the timestamp and ID in the event with the values stored in the entry to decide whether the local system should apply the potentially conflicting event.
`TransactionEvent`	`TransactionListener`, `TransactionWriter`	Describes the work done in a transaction. This event may be for a pending or committed transaction, or for the work abandoned by an explicit rollback or failed commit. The work is represented by an ordered list of `EntryEvent` instances. The entry events are listed in the order in which the operations were performed in the transaction. As the transaction operations are performed, the entry events are conflated, with only the last event for each entry remaining in the list. So if entry A is modified, then entry B, then entry A, the list will contain the event for entry B followed by the second event for entry A.