Package javax.cache.event

This package contains event listener interfaces.

These may be registered for callback notification of the cache events. The specific interface should be implemented for each event type a callback is desired on.

Event notifications occur synchronously in the line of execution of the calling thread. The calling thread blocks until the listener has completed execution or thrown a CacheEntryCreatedListener.

Listeners are invoked after the cache is updated. If the listener throws an CacheEntryCreatedListener this will propagate back to the caller but it does not affect the cache update as it already completed before the listener was called.

Since:

1.0

Author:

Greg Luck, Yannis Cosmadopoulos

Interface Summary

Interface	Description
CacheEntryCreatedListener<K,V>	Invoked after a cache entry is created, or if a batch call is made, after the entries are created.
CacheEntryEventFilter<K,V>	A function that may be used to check CacheEntryEvents prior to being dispatched to CacheEntryListeners.
CacheEntryExpiredListener<K,V>	Invoked if a cache entry or entries are evicted due to expiration.
CacheEntryListener<K,V>	A tagging interface for cache entry listeners.
CacheEntryRemovedListener<K,V>	Invoked if a cache entry is removed, or if a batch call is made, after the entries are removed.
CacheEntryUpdatedListener<K,V>	Invoked if an existing cache entry is updated, or if a batch call is made, after the entries are updated.

Class Summary

Class	Description
CacheEntryEvent<K,V>	A Cache entry event base class.

Enum Summary

Enum	Description
EventType	The type of event received by the listener.

Exception Summary

Exception	Description
CacheEntryListenerException	An exception to indicate a problem has occurred with a listener.