Package org.ehcache

Interface PersistentCacheManager

All Superinterfaces:

AutoCloseable, CacheManager, Closeable

public interface PersistentCacheManager
extends CacheManager

A CacheManager that knows how to lifecycle caches that can outlive the JVM.

Method Summary

Modifier and Type	Method	Description
void	destroy()	Destroys all persistent data associated with this PersistentCacheManager.
void	destroyCache(String alias)	Destroys all data persistent data associated with the aliased Cache instance managed by this CacheManager.

Methods inherited from interface org.ehcache.CacheManager

close, createCache, createCache, getCache, getRuntimeConfiguration, getStatus, init, removeCache

Method Detail

destroy

void destroy()
      throws CachePersistenceException

Destroys all persistent data associated with this PersistentCacheManager.

This is achieved by putting the CacheManager in MAINTENANCE mode, executing the destroy and then exiting the MAINTENANCE mode.

Throws:

IllegalStateException - if state maintenance couldn't be reached

CachePersistenceException - when something goes wrong destroying the persistent data

destroyCache

void destroyCache(String alias)
           throws CachePersistenceException

Destroys all data persistent data associated with the aliased Cache instance managed by this CacheManager.

This requires the CacheManager to be either in AVAILABLE or MAINTENANCE mode.

• If the CacheManager is AVAILABLE, the operation is executed without lifecycle interactions.
• If the CacheManager is not AVAILABLE then it attempts to go into MAINTENANCE. Upon success, the destroyCache operation is performed and then MAINTENANCE mode is exited. On failure, an exception will be thrown and no destroy will have happened.

Parameters:

alias - the Cache's alias to destroy all persistent data from

Throws:

CachePersistenceException - when something goes wrong destroying the persistent data