Package org.ehcache

Interface PersistentCacheManager

  • All Superinterfaces:
    java.lang.AutoCloseable, CacheManager, java.io.Closeable

    public interface PersistentCacheManager
    extends CacheManager
    A CacheManager that knows how to lifecycle caches that can outlive the JVM.
    • 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:
        java.lang.IllegalStateException - if state maintenance couldn't be reached
        CachePersistenceException - when something goes wrong destroying the persistent data
      • destroyCache

        void destroyCache​(java.lang.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