javax.cache.event
Interface CacheEntryListener<K,V>

Type Parameters:

K - the type of keys maintained by the associated cache

V - the type of values maintained by the associated cache

All Superinterfaces:

EventListener

All Known Subinterfaces:

CacheEntryCreatedListener<K,V>, CacheEntryExpiredListener<K,V>, CacheEntryReadListener<K,V>, CacheEntryRemovedListener<K,V>, CacheEntryUpdatedListener<K,V>

public interface CacheEntryListener<K,V>
extends EventListener

Tagging interface for cache entry listeners.

Sub-interfaces exist for the various cache events allowing a listener to be created which implements only those listeners it is interested in.

The motivation for this design is to allow efficient implementation of network based listeners.

Listeners should be implemented with care. In particular it is important to consider the impact on performance and latency.

A listener is a user supplied object instance and therefore can only be registered programmatically.

The listeners are fired:

• in order in which they were registered
• after the entry is added to the cache
• If the event is registered with synchronous notification, it is fired synchronously in the same thread if in the same JVM

Because a listener occurs... todo simplify back to one todo Java SE wants one method per listener. Yannis to find email todo say something about exceptions todo say the key cannot be mutated?

Since:

1.0

Author:

Yannis Cosmadopoulos, Greg Luck

See Also:

CacheEntryCreatedListener, CacheEntryUpdatedListener, CacheEntryReadListener, CacheEntryRemovedListener, CacheEntryExpiredListener