|
ehcache | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Allows implementers to register callback methods that will be executed when a cache event occurs. The events include:
CacheManagerEventListener
Method Summary | |
void |
dispose()
Give the replicator a chance to cleanup and free resources when no longer needed |
void |
notifyElementExpired(Cache cache,
Element element)
Called immediately after an element is found to be expired. |
void |
notifyElementPut(Cache cache,
Element element)
Called immediately after an element has been put into the cache. |
void |
notifyElementRemoved(Cache cache,
Element element)
Called immediately after an element has been removed. |
void |
notifyElementUpdated(Cache cache,
Element element)
Called immediately after an element has been put into the cache and the element already existed in the cache. |
Method Detail |
public void notifyElementRemoved(Cache cache, Element element) throws CacheException
Element
has been removed, only what was the key of the element is known.
cache
- the cache emitting the notificationelement
- just deleted
CacheException
public void notifyElementPut(Cache cache, Element element) throws CacheException
Cache.put(net.sf.ehcache.Element)
method
will block until this method returns.
Implementers may wish to have access to the Element's fields, including value, so the element is provided.
Implementers should be careful not to modify the element. The effect of any modifications is undefined.
cache
- the cache emitting the notificationelement
- the element which was just put into the cache.
CacheException
public void notifyElementUpdated(Cache cache, Element element) throws CacheException
Cache.put(net.sf.ehcache.Element)
method
will block until this method returns.
Implementers may wish to have access to the Element's fields, including value, so the element is provided.
Implementers should be careful not to modify the element. The effect of any modifications is undefined.
cache
- the cache emitting the notificationelement
- the element which was just put into the cache.
CacheException
public void notifyElementExpired(Cache cache, Element element)
Cache.remove(Object)
method will block until this method returns.
As the Element
has been expired, only what was the key of the element is known.
Elements are checked for expiry in ehcache at the following times:
Cache.DEFAULT_EXPIRY_THREAD_INTERVAL_SECONDS
cache
- the cache emitting the notificationelement
- the element that has just expired
Deadlock Warning: expiry will often come from the DiskStore
expiry thread. It holds a lock to the
DiskStorea the time the notification is sent. If the implementation of this method calls into a
synchronized Cache
method and that subsequently calls into DiskStore a deadlock will result.
Accordingly implementers of this method should not call back into Cache.public void dispose()
|
ehcache | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |