Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
net.sf.ehcache.store.compound.CopyStrategy replaced by ReadWriteCopyStrategy

Deprecated Classes

Class and Description
net.sf.ehcache.config.generator.ConfigurationGenerator Use ConfigurationUtil.generateCacheManagerConfigurationText(Configuration) or ConfigurationUtil.generateCacheConfigurationText(Configuration, CacheConfiguration) instead
net.sf.ehcache.hibernate.EhCache
net.sf.ehcache.hibernate.ccs.EhcacheNonstrictReadWriteCache
net.sf.ehcache.hibernate.EhCacheProvider
net.sf.ehcache.hibernate.ccs.EhcacheReadOnlyCache
net.sf.ehcache.hibernate.ccs.EhcacheReadWriteCache
net.sf.ehcache.hibernate.SingletonEhCacheProvider

Deprecated Fields

Field and Description
net.sf.ehcache.config.TerracottaConfiguration.DEFAULT_CACHE_COHERENT since 2.4 Use TerracottaConfiguration.DEFAULT_CONSISTENCY_TYPE instead.
net.sf.ehcache.config.CacheConfiguration.DEFAULT_DISK_PERSISTENT The diskPersistent attribute has been replaced with CacheConfiguration.persistence(PersistenceConfiguration).
net.sf.ehcache.config.CacheConfiguration.diskPersistent The diskPersistent attribute has been replaced with CacheConfiguration.persistence(PersistenceConfiguration).
net.sf.ehcache.config.CacheConfiguration.overflowToDisk The overflowToDisk attribute has been replaced with PersistenceConfiguration.Strategy.LOCALTEMPSWAP.

Deprecated Methods

Method and Description
net.sf.ehcache.Ehcache.calculateInMemorySize()
net.sf.ehcache.Cache.calculateInMemorySize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.calculateInMemorySize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.calculateInMemorySize()
net.sf.ehcache.Ehcache.calculateOffHeapSize()
net.sf.ehcache.Cache.calculateOffHeapSize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.calculateOffHeapSize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.calculateOffHeapSize()
net.sf.ehcache.Ehcache.calculateOnDiskSize()
net.sf.ehcache.Cache.calculateOnDiskSize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.calculateOnDiskSize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.calculateOnDiskSize()
net.sf.ehcache.config.TerracottaConfiguration.coherent(boolean) since 2.4 Use TerracottaConfiguration.consistency(Consistency) instead
net.sf.ehcache.config.TerracottaConfiguration.coherentReads(boolean)
net.sf.ehcache.store.CachingTier.contains(K)
net.sf.ehcache.store.CacheStore.containsKeyInMemory(Object)
net.sf.ehcache.store.CacheStore.containsKeyOffHeap(Object)
net.sf.ehcache.store.CacheStore.containsKeyOnDisk(Object)
net.sf.ehcache.config.TerracottaConfiguration.copyOnRead(boolean)
net.sf.ehcache.config.CacheConfiguration.diskPersistent(boolean) The diskPersistent attribute has been replaced with CacheConfiguration.persistence(PersistenceConfiguration).
net.sf.ehcache.store.cachingtier.HeapCacheBackEnd.entrySet()
net.sf.ehcache.config.generator.ConfigurationGenerator.generate(Configuration, CacheConfiguration) use appropriate methods in ConfigurationUtil instead
net.sf.ehcache.config.generator.ConfigurationGenerator.generate(Configuration, CacheConfiguration, Map<String, CacheConfiguration>) use appropriate methods in ConfigurationUtil instead
net.sf.ehcache.config.TerracottaConfiguration.getCoherentReads()
net.sf.ehcache.Ehcache.getDiskStoreSize()
net.sf.ehcache.Cache.getDiskStoreSize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.getDiskStoreSize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.getDiskStoreSize()
net.sf.ehcache.store.CachingTier.getEvictionPolicy()
net.sf.ehcache.management.sampled.SampledCache.getInMemorySize() use SampledCache.getLocalHeapSize()
net.sf.ehcache.management.sampled.LegacyCacheStatistics.getInMemorySize() use LegacyCacheStatistics.getLocalHeapSize()
net.sf.ehcache.store.CachingTier.getInMemorySize()
net.sf.ehcache.store.CachingTier.getInMemorySizeInBytes()
net.sf.ehcache.store.CacheStore.getInternalContext()
net.sf.ehcache.Element.getKey() Please use Element.getObjectKey() instead.
net.sf.ehcache.Ehcache.getKeysNoDuplicateCheck() versions since 2.1 do not return duplicates
net.sf.ehcache.management.CacheConfigurationMBean.getMaxElementsInMemory() use CacheConfigurationMBean.getMaxEntriesLocalHeap()
net.sf.ehcache.management.CacheConfiguration.getMaxElementsInMemory() use CacheConfiguration.getMaxEntriesLocalHeap()
net.sf.ehcache.management.sampled.SampledCacheMBean.getMaxElementsInMemory() use CacheSampler.getMaxEntriesLocalHeap() instead
net.sf.ehcache.config.CacheConfiguration.getMaxElementsInMemory() use CacheConfiguration.getMaxEntriesLocalHeap()
net.sf.ehcache.management.CacheConfigurationMBean.getMaxElementsOnDisk() use CacheConfigurationMBean.getMaxEntriesLocalDisk()
net.sf.ehcache.management.CacheConfiguration.getMaxElementsOnDisk() use CacheConfiguration.getMaxEntriesLocalDisk()
net.sf.ehcache.config.CacheConfiguration.getMaxElementsOnDisk() use CacheConfiguration.getMaxEntriesLocalDisk() for unclustered caches and CacheConfiguration.getMaxEntriesInCache() for clustered caches.
net.sf.ehcache.config.CacheConfiguration.getMaxMemoryOffHeap() See CacheConfiguration.getMaxBytesLocalOffHeapAsString()
net.sf.ehcache.management.CacheConfigurationMBean.getMaxMemoryOffHeapInBytes() use CacheConfigurationMBean.getMaxBytesLocalOffHeap()
net.sf.ehcache.management.CacheConfiguration.getMaxMemoryOffHeapInBytes() use CacheConfiguration.getMaxBytesLocalOffHeap()
net.sf.ehcache.config.CacheConfiguration.getMaxMemoryOffHeapInBytes() CacheConfiguration.getMaxBytesLocalOffHeap()
net.sf.ehcache.Ehcache.getMemoryStoreSize()
net.sf.ehcache.Cache.getMemoryStoreSize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.getMemoryStoreSize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.getMemoryStoreSize()
net.sf.ehcache.Element.getNextToLastAccessTime() The nextToLastAccessTime field is unused since version 1.7, retrieving it will return the lastAccessTime. Use #getLastAccessTime() instead.
net.sf.ehcache.management.sampled.SampledCache.getOffHeapSize() use SampledCache.getLocalOffHeapSize()
net.sf.ehcache.management.sampled.LegacyCacheStatistics.getOffHeapSize() use LegacyCacheStatistics.getLocalOffHeapSize()
net.sf.ehcache.management.sampled.CacheSamplerImpl.getOffHeapSize() use CacheSamplerImpl.getLocalOffHeapSize()
net.sf.ehcache.store.CachingTier.getOffHeapSize()
net.sf.ehcache.store.CachingTier.getOffHeapSizeInBytes()
net.sf.ehcache.Ehcache.getOffHeapStoreSize()
net.sf.ehcache.Cache.getOffHeapStoreSize()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.getOffHeapStoreSize()
net.sf.ehcache.constructs.classloader.ClassLoaderAwareCache.getOffHeapStoreSize()
net.sf.ehcache.management.sampled.SampledCache.getOnDiskSize() use SampledCache.getLocalDiskSize()
net.sf.ehcache.management.sampled.LegacyCacheStatistics.getOnDiskSize() use LegacyCacheStatistics.getLocalDiskSize()
net.sf.ehcache.management.sampled.CacheSamplerImpl.getOnDiskSize() use CacheSamplerImpl.getLocalDiskSize()
net.sf.ehcache.store.CachingTier.getOnDiskSizeInBytes()
net.sf.ehcache.store.cachingtier.HeapCacheBackEnd.getPolicy()
net.sf.ehcache.config.ConfigurationHelper.getSearchAttributeType(SearchAttribute, ClassLoader) internal use only
net.sf.ehcache.store.cachingtier.PooledBasedBackEnd.getSizeInBytes()
net.sf.ehcache.store.StoreQuery.getTargets()
net.sf.ehcache.config.Configuration.getUpdateCheck()
net.sf.ehcache.Element.getValue() Please use Element.getObjectValue() instead.
net.sf.ehcache.Ehcache.isClusterCoherent() Use Ehcache.isClusterBulkLoadEnabled() instead
net.sf.ehcache.Cache.isClusterCoherent() use Cache.isClusterBulkLoadEnabled() instead
net.sf.ehcache.management.sampled.SampledCacheMBean.isClusterCoherent() use CacheSampler.isClusterBulkLoadEnabled() instead
net.sf.ehcache.management.sampled.SampledCache.isClusterCoherent()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.isClusterCoherent() Use EhcacheDecoratorAdapter.isClusterBulkLoadEnabled() instead
net.sf.ehcache.config.TerracottaConfiguration.isCoherent() since 2.4 Use TerracottaConfiguration.getConsistency() instead to query the TerracottaConfiguration.Consistency or Ehcache#isNodeCoherent() to query if the node is coherent
net.sf.ehcache.config.TerracottaConfiguration.isCopyOnRead()
net.sf.ehcache.config.CacheConfiguration.isDiskPersistent() The diskPersistent attribute has been replaced with CacheConfiguration.persistence(PersistenceConfiguration).
net.sf.ehcache.Ehcache.isNodeCoherent() Use Ehcache.isNodeBulkLoadEnabled() instead
net.sf.ehcache.Cache.isNodeCoherent() use Cache.isNodeBulkLoadEnabled() instead
net.sf.ehcache.management.sampled.SampledCacheMBean.isNodeCoherent() use CacheSampler.isNodeBulkLoadEnabled() instead
net.sf.ehcache.management.sampled.SampledCache.isNodeCoherent()
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.isNodeCoherent() Use EhcacheDecoratorAdapter.isNodeBulkLoadEnabled() instead
net.sf.ehcache.config.CacheConfiguration.isOverflowToDisk() The overflowToDisk attribute has been replaced with PersistenceConfiguration.Strategy.LOCALTEMPSWAP.
net.sf.ehcache.config.CacheConfiguration.maxElementsInMemory(int) use CacheConfiguration.maxEntriesLocalHeap(int)
net.sf.ehcache.config.CacheConfiguration.maxElementsOnDisk(int) use CacheConfiguration.maxEntriesLocalDisk(int) for unclustered caches and CacheConfiguration.maxEntriesInCache(long) for clustered caches.
net.sf.ehcache.config.CacheConfiguration.maxMemoryOffHeap(String) See CacheConfiguration.maxBytesLocalOffHeap(long, net.sf.ehcache.config.MemoryUnit)
net.sf.ehcache.store.MemoryStore.BackingFactory.newBackingMap(PoolAccessor, int, float, int, int, RegisteredEventListeners)
net.sf.ehcache.statistics.CacheUsageListener.notifyTimeTakenForGet(long)
net.sf.ehcache.config.CacheConfiguration.overflowToDisk(boolean) The overflowToDisk attribute has been replaced with PersistenceConfiguration.Strategy.LOCALTEMPSWAP.
net.sf.ehcache.store.AuthoritativeTier.putFaulted(Element)
net.sf.ehcache.util.concurrent.ConcurrentHashMap.recalculateSize(K)
net.sf.ehcache.store.CachingTier.recalculateSize(K)
net.sf.ehcache.store.cachingtier.HeapCacheBackEnd.recalculateSize(K)
net.sf.ehcache.CacheManager.removalAll() use CacheManager.removeAllCaches() instead
net.sf.ehcache.config.TerracottaConfiguration.setCoherent(boolean) since 2.4 Use TerracottaConfiguration.setConsistency(Consistency) instead
net.sf.ehcache.config.TerracottaConfiguration.setCoherentReads(boolean)
net.sf.ehcache.config.TerracottaConfiguration.setCopyOnRead(boolean)
net.sf.ehcache.Element.setCreateTime() Resetting the creation time is not recommended as of version 1.7
net.sf.ehcache.config.CacheConfiguration.setDiskPersistent(boolean) The diskPersistent attribute has been replaced with CacheConfiguration.persistence(PersistenceConfiguration).
net.sf.ehcache.store.CachingTier.setEvictionPolicy(Policy)
net.sf.ehcache.management.CacheConfigurationMBean.setMaxElementsInMemory(int) use CacheConfigurationMBean.setMaxEntriesLocalHeap(long)
net.sf.ehcache.management.CacheConfiguration.setMaxElementsInMemory(int) use CacheConfiguration.setMaxEntriesLocalHeap(long)
net.sf.ehcache.management.sampled.SampledCacheMBean.setMaxElementsInMemory(int) use CacheSampler.setMaxEntriesLocalHeap(long maxElements) instead
net.sf.ehcache.config.CacheConfiguration.setMaxElementsInMemory(int) use CacheConfiguration.setMaxEntriesLocalHeap(long)
net.sf.ehcache.management.CacheConfigurationMBean.setMaxElementsOnDisk(int) use CacheConfigurationMBean.setMaxEntriesLocalDisk(long)
net.sf.ehcache.management.CacheConfiguration.setMaxElementsOnDisk(int) use CacheConfiguration.setMaxEntriesLocalDisk(long)
net.sf.ehcache.config.CacheConfiguration.setMaxElementsOnDisk(int) use CacheConfiguration.setMaxEntriesLocalDisk(long) for unclustered caches and CacheConfiguration.setMaxEntriesInCache(long) for clustered caches.
net.sf.ehcache.config.CacheConfiguration.setMaxMemoryOffHeap(String) See CacheConfiguration.setMaxBytesLocalOffHeap(java.lang.String)
net.sf.ehcache.Ehcache.setNodeCoherent(boolean) Use Ehcache.setNodeBulkLoadEnabled(boolean) instead
net.sf.ehcache.Cache.setNodeCoherent(boolean) use Cache.setNodeBulkLoadEnabled(boolean) instead
net.sf.ehcache.management.sampled.SampledCacheMBean.setNodeCoherent(boolean) use CacheSampler.setNodeBulkLoadEnabled(boolean) instead
net.sf.ehcache.management.sampled.SampledCache.setNodeCoherent(boolean) use SampledCache.setNodeBulkLoadEnabled(boolean) instead
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.setNodeCoherent(boolean) Use EhcacheDecoratorAdapter.setNodeBulkLoadEnabled(boolean) instead
net.sf.ehcache.config.CacheConfiguration.setOverflowToDisk(boolean) The overflowToDisk attribute has been replaced with PersistenceConfiguration.Strategy.LOCALTEMPSWAP.
net.sf.ehcache.store.cachingtier.HeapCacheBackEnd.setPolicy(Policy)
net.sf.ehcache.config.CacheConfiguration.setStatistics(boolean)
net.sf.ehcache.config.Configuration.setUpdateCheck(boolean)
net.sf.ehcache.store.cachingtier.HeapCacheBackEnd.size()
net.sf.ehcache.config.CacheConfiguration.statistics(boolean)
net.sf.ehcache.store.StoreQuery.targets(String[])
net.sf.ehcache.config.Configuration.updateCheck(boolean)
net.sf.ehcache.Ehcache.waitUntilClusterCoherent() Use Ehcache.waitUntilClusterBulkLoadComplete() instead
net.sf.ehcache.Cache.waitUntilClusterCoherent() use Cache.waitUntilClusterBulkLoadComplete() instead
net.sf.ehcache.constructs.EhcacheDecoratorAdapter.waitUntilClusterCoherent() Use EhcacheDecoratorAdapter.waitUntilClusterBulkLoadComplete() instead

Deprecated Constructors

Constructor and Description
net.sf.ehcache.store.CacheStore(CachingTier<Object, Element>, AuthoritativeTier, CacheConfiguration)
net.sf.ehcache.Element(Object, Object, Boolean, Integer, Integer)
net.sf.ehcache.Element(Object, Object, long, long, long, long, long, long) The nextToLastAccessTime field is unused since version 1.7, setting it will have no effect. Use #Element(Object, Object, long, long, long, long, long) instead