Package javax.cache.event

Class CacheEntryEvent<K,V>

java.lang.Object

java.util.EventObject

javax.cache.event.CacheEntryEvent<K,V>

Type Parameters:

K - the type of key

V - the type of value

All Implemented Interfaces:

Serializable, Cache.Entry<K,V>

public abstract class CacheEntryEvent<K,V>
extends EventObject
implements Cache.Entry<K,V>

A Cache entry event base class.

Since:

1.0

Author:

Greg Luck

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor	Description
CacheEntryEvent(Cache source, EventType eventType)	Constructs a cache entry event from a given cache as source

Method Summary

Modifier and Type	Method	Description
EventType	getEventType()	Gets the event type of this event
abstract V	getOldValue()	Returns the previous value that existed for entry in the cache before modification or removal.
Cache	getSource()
abstract V	getValue()	Returns the value stored in the cache when this entry was created or updated.
abstract boolean	isOldValueAvailable()	Whether the old value is available.

Methods inherited from interface javax.cache.Cache.Entry

getKey, unwrap

Methods inherited from class java.util.EventObject

toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CacheEntryEvent

public CacheEntryEvent(Cache source,
                       EventType eventType)

Constructs a cache entry event from a given cache as source

Parameters:

source - the cache that originated the event

eventType - the event type for this event

Method Detail

getSource

public final Cache getSource()

Overrides:

getSource in class EventObject

getValue

public abstract V getValue()

Returns the value stored in the cache when this entry was created or updated.

The value will be available for CacheEntryCreatedListener and CacheEntryUpdatedListener. Returns the same value as getOldValue() for CacheEntryExpiredListener and CacheEntryRemovedListener. Cache clients that need to maintain compatibility with JSR107 version 1.0 cache implementations, need to use this method for retrieving the expired or removed value. When using cache implementations compatible with JSR107 version 1.1, clients should prefer the method getOldValue().

Specified by:

getValue in interface Cache.Entry<K,V>

Returns:

the value corresponding to this entry

See Also:

getOldValue()

getOldValue

public abstract V getOldValue()

Returns the previous value that existed for entry in the cache before modification or removal. The old value will be available for CacheEntryUpdatedListener, CacheEntryExpiredListener and CacheEntryRemovedListener if CacheEntryListenerConfiguration.isOldValueRequired() is true. The old value may be available for CacheEntryUpdatedListener, CacheEntryExpiredListener and CacheEntryRemovedListener if CacheEntryListenerConfiguration.isOldValueRequired() is false.

Returns:

the previous value or null if there was no previous value or the previous value is not available

isOldValueAvailable

public abstract boolean isOldValueAvailable()

Whether the old value is available. The old value will be available for CacheEntryUpdatedListener, CacheEntryExpiredListener and CacheEntryRemovedListener if CacheEntryListenerConfiguration.isOldValueRequired() is true. The old value may be available for CacheEntryUpdatedListener, CacheEntryExpiredListener and CacheEntryRemovedListener if CacheEntryListenerConfiguration.isOldValueRequired() is false.

Returns:

true if the old value is definitely available

getEventType

public final EventType getEventType()

Gets the event type of this event

Returns:

the event type.