Deprecated API

Contents

• Deprecated Packages
• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Packages

Package and Description
org.infinispan.commons.equivalence This package will be removed in a future version, Equivalence is no longer required for byte[]

Deprecated Interfaces

Interface and Description
org.infinispan.lifecycle.Lifecycle use Lifecycle instead

Deprecated Classes

Class and Description
org.infinispan.AbstractDelegatingAdvancedCache Extend from AbstractDelegatingAdvancedCache instead. This class will be removed in the future.
org.infinispan.AbstractDelegatingCache Extend from AbstractDelegatingCache instead. This class will be removed in the future.
org.infinispan.manager.AbstractDelegatingEmbeddedCacheManager Extend from AbstractDelegatingEmbeddedCacheManager instead. This class will be removed in the future.
org.infinispan.commons.equivalence.AnyEquivalence
org.infinispan.commons.equivalence.AnyServerEquivalence
org.infinispan.commons.util.Base64 Not currently used internally by Infinispan; will be removed in ver. 10. Other users are advised to replace it with Base64.
org.infinispan.interceptors.base.BaseCustomInterceptor Since 9.0, use BaseCustomAsyncInterceptor instead.
org.infinispan.commons.equivalence.ByteArrayEquivalence
org.infinispan.io.ByteBufferImpl
org.infinispan.interceptors.base.CommandInterceptor Since 9.0, please extend BaseAsyncInterceptor instead.
org.infinispan.commons.equivalence.EquivalentHashMap
org.infinispan.commons.equivalence.EquivalentHashSet
org.infinispan.commons.equivalence.EquivalentLinkedHashMap
org.infinispan.configuration.cache.EvictionConfiguration Use MemoryConfiguration instead
org.infinispan.configuration.cache.EvictionConfigurationBuilder Use MemoryConfiguration instead
org.infinispan.io.ExposedByteArrayOutputStream
org.infinispan.commons.equivalence.IdentityEquivalence
org.infinispan.affinity.KeyAffinityServiceImpl Extend from KeyAffinityServiceImpl instead. This class will be removed in the future.
org.infinispan.interceptors.base.PrePostProcessingCommandInterceptor Since 9.0, please extend AsyncInterceptor instead.
org.infinispan.configuration.cache.SingletonStoreConfiguration Singleton writers will be removed in 10.0. If it is desirable that all nodes don't write to the underlying store then a shared store should be used instead, as this only performs store writes at a key's primary owner.
org.infinispan.configuration.cache.SingletonStoreConfigurationBuilder Singleton writers will be removed in 10.0. If it is desirable that all nodes don't write to the underlying store then a shared store should be used instead, as this only performs store writes at a key's primary owner.
org.infinispan.configuration.cache.StoreAsBinaryConfiguration Use MemoryConfiguration instead
org.infinispan.configuration.cache.StoreAsBinaryConfigurationBuilder Please use MemoryConfigurationBuilder.storageType(StorageType) method instead
org.infinispan.configuration.cache.SyncConfiguration Since 9.0, the replTimeout attribute is now ClusteringConfiguration.remoteTimeout.
org.infinispan.configuration.cache.SyncConfigurationBuilder Since 9.0, the replTimeout attribute is now ClusteringConfigurationBuilder.remoteTimeout.

Deprecated Fields

Field and Description
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.fetchPersistentState
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.ignoreModifications
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.preload
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.properties
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.purgeOnStartup
org.infinispan.configuration.cache.SyncConfiguration.REPL_TIMEOUT Since 9.0, replaced with ClusteringConfiguration.REMOTE_TIMEOUT
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder.shared

Deprecated Methods

Method and Description
org.infinispan.commons.CacheConfigurationException.addErroneousAttribute(String)
org.infinispan.AdvancedCache.addInterceptor(CommandInterceptor, int) Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.AdvancedCache.addInterceptorAfter(CommandInterceptor, Class<? extends CommandInterceptor>) Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.AdvancedCache.addInterceptorBefore(CommandInterceptor, Class<? extends CommandInterceptor>) Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.configuration.global.GlobalConfiguration.asyncListenerExecutor() This method always returns null now. Look for a thread pool named as GlobalConfiguration.listenerThreadPool() instead.
org.infinispan.configuration.global.GlobalConfiguration.asyncTransportExecutor() This method always returns null now. Look for a thread pool named as TransportConfiguration.transportThreadPool() instead.
org.infinispan.server.memcached.configuration.MemcachedServerConfigurationBuilder.cache(String)
org.infinispan.client.hotrod.configuration.Configuration.classLoader()
org.infinispan.client.hotrod.configuration.ConfigurationChildBuilder.classLoader(ClassLoader) since 9.0. If you need to load configuration resources from other locations, you will need to do so yourself and use the appropriate configuration methods (e.g. SslConfigurationBuilder.sslContext(SSLContext))
org.infinispan.configuration.cache.HashConfiguration.consistentHash() Since 5.2, replaced by HashConfiguration.consistentHashFactory().
org.infinispan.configuration.cache.HashConfigurationBuilder.consistentHash(ConsistentHash) Since 5.2, replaced by HashConfigurationBuilder.consistentHashFactory(ConsistentHashFactory).
org.infinispan.configuration.cache.DataContainerConfiguration.dataContainer() data container is no longer to exposed via configuration at a later point
org.infinispan.configuration.cache.DataContainerConfigurationBuilder.dataContainer(DataContainer) data container is no longer to exposed via configuration at a later point
org.infinispan.configuration.cache.StoreAsBinaryConfiguration.defensive() Store as binary configuration is always defensive now.
org.infinispan.configuration.cache.StoreAsBinaryConfigurationBuilder.defensive(boolean) Store as binary configuration is always defensive now.
org.infinispan.configuration.cache.IndexingConfigurationBuilder.disable() Use IndexingConfigurationBuilder.index(Index) instead
org.infinispan.configuration.cache.TransactionConfiguration.eagerLockingSingleNode() starting with Infinispan 5.1 single node locking is used by default
org.infinispan.configuration.cache.TransactionConfigurationBuilder.eagerLockingSingleNode(boolean) starting with Infinispan 5.1 single node locking is used by default
org.infinispan.configuration.cache.IndexingConfigurationBuilder.enable() Use IndexingConfigurationBuilder.index(Index) instead
org.infinispan.configuration.cache.IndexingConfiguration.enabled() Use IndexingConfiguration.index() instead
org.infinispan.configuration.cache.IndexingConfigurationBuilder.enabled(boolean) Use IndexingConfigurationBuilder.index(Index) instead
org.infinispan.configuration.cache.ConfigurationBuilder.eviction() Use ConfigurationBuilder.memory() instead
org.infinispan.configuration.cache.Configuration.eviction() please use Configuration.memory()
org.infinispan.configuration.global.GlobalConfiguration.evictionScheduledExecutor() This method always returns null now. Look for a thread pool named as GlobalConfiguration.expirationThreadPool() instead.
org.infinispan.configuration.global.GlobalConfigurationChildBuilder.evictionThreadPool()
org.infinispan.configuration.global.GlobalConfigurationBuilder.evictionThreadPool() this returns the thread pool returned from GlobalConfigurationBuilder.expirationThreadPool
org.infinispan.configuration.global.GlobalConfiguration.evictionThreadPool() Use GlobalConfiguration.expirationThreadPool instead
org.infinispan.configuration.cache.AsyncStoreConfiguration.flushLockTimeout()
org.infinispan.configuration.cache.AsyncStoreConfigurationBuilder.flushLockTimeout(long)
org.infinispan.configuration.cache.AsyncStoreConfiguration.flushLockTimeout(long)
org.infinispan.configuration.cache.AsyncStoreConfigurationBuilder.flushLockTimeout(long, TimeUnit)
org.infinispan.client.hotrod.RemoteCache.getBulk() Bulk retrievals can be quite expensive if for large data sets. Alternatively, the different retrieveEntries* methods offer lazy, pull-style, methods that retrieve bulk data more efficiently.
org.infinispan.client.hotrod.RemoteCache.getBulk(int) Bulk retrievals can be quite expensive if for large data sets. Alternatively, the different retrieveEntries* methods offer lazy, pull-style, methods that retrieve bulk data more efficiently.
org.infinispan.commons.CacheConfigurationException.getErroneousAttributes()
org.infinispan.distribution.ch.ConsistentHash.getHashFunction() Since 8.2, the Hash is optional - replaced in the configuration by the KeyPartitioner
org.infinispan.rest.configuration.RestServerConfiguration.getIgnoredCaches() Use ProtocolServerConfiguration.ignoredCaches() instead.
org.infinispan.AdvancedCache.getInterceptorChain() Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.AdvancedCache.getInvocationContextContainer() No longer in use, implementations might return null.
org.infinispan.client.hotrod.RemoteCache.getVersioned(K) Use RemoteCache.getWithMetadata(Object) instead
org.infinispan.configuration.cache.HashConfiguration.hash() Since 8.2, use HashConfiguration.keyPartitioner() instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.hash(Hash) Since 8.2, use HashConfigurationBuilder.keyPartitioner(KeyPartitioner) instead.
org.infinispan.configuration.cache.IndexingConfiguration.indexLocalOnly() Use IndexingConfiguration.index() instead
org.infinispan.configuration.cache.IndexingConfigurationBuilder.indexLocalOnly(boolean) Use IndexingConfigurationBuilder.index(Index) instead
org.infinispan.transaction.lookup.JBossStandaloneJTAManagerLookup.init(Configuration) Use JBossStandaloneJTAManagerLookup.init(org.infinispan.configuration.global.GlobalConfiguration) instead since Configuration has no access to classloader any more.
org.infinispan.configuration.cache.InterceptorConfiguration.interceptor() Since 9.0, please use InterceptorConfiguration.asyncInterceptor() instead.
org.infinispan.configuration.cache.InterceptorConfigurationBuilder.interceptor(CommandInterceptor) Since 9.0, please use InterceptorConfigurationBuilder.interceptor(AsyncInterceptor) instead.
org.infinispan.configuration.cache.InterceptorConfiguration.interceptorClass() Since 9.0, please use InterceptorConfiguration.sequentialInterceptorClass() instead.
org.infinispan.configuration.cache.EvictionConfigurationBuilder.maxEntries(int)
org.infinispan.configuration.cache.EvictionConfigurationBuilder.maxEntries(long)
org.infinispan.configuration.cache.HashConfigurationBuilder.numVirtualNodes(int) No longer used since 5.2, replaced by HashConfigurationBuilder.numSegments(int) (which works like a numVirtualNodes value for the entire cluster).
org.infinispan.configuration.global.GlobalConfiguration.persistenceExecutor() This method always returns null now. Look for a thread pool named as GlobalConfiguration.persistenceThreadPool() instead.
org.infinispan.persistence.remote.configuration.RemoteStoreConfiguration.protocolVersion()
org.infinispan.client.hotrod.configuration.Configuration.protocolVersion() Use Configuration.version() instead.
org.infinispan.persistence.remote.configuration.RemoteStoreConfigurationChildBuilder.protocolVersion(String) Use RemoteStoreConfigurationChildBuilder.protocolVersion(ProtocolVersion) instead
org.infinispan.client.hotrod.configuration.ConfigurationChildBuilder.protocolVersion(String) Use ConfigurationChildBuilder.version(ProtocolVersion) instead.
org.infinispan.client.hotrod.configuration.ConfigurationBuilder.protocolVersion(String) Use ConfigurationBuilder.version(ProtocolVersion) instead.
org.infinispan.client.hotrod.configuration.AbstractConfigurationChildBuilder.protocolVersion(String) Use AbstractConfigurationChildBuilder.version(ProtocolVersion) instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.rehashDisabled() Use StateTransferConfigurationBuilder.fetchInMemoryState(boolean) instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.rehashEnabled() Use StateTransferConfigurationBuilder.fetchInMemoryState(boolean) instead.
org.infinispan.configuration.cache.HashConfiguration.rehashEnabled() Use StateTransferConfiguration.fetchInMemoryState() instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.rehashEnabled(boolean) Use StateTransferConfigurationBuilder.fetchInMemoryState(boolean) instead.
org.infinispan.configuration.cache.HashConfiguration.rehashRpcTimeout() Use StateTransferConfiguration.timeout() instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.rehashRpcTimeout(long) Use StateTransferConfigurationBuilder.timeout(long) instead.
org.infinispan.configuration.cache.HashConfiguration.rehashWait() Use StateTransferConfiguration.timeout() instead.
org.infinispan.configuration.cache.HashConfigurationBuilder.rehashWait(long) No longer used.
org.infinispan.configuration.global.GlobalConfiguration.remoteCommandsExecutor() This method always returns null now. Look for a thread pool named as TransportConfiguration.remoteCommandThreadPool() instead.
org.infinispan.AdvancedCache.removeInterceptor(Class<? extends CommandInterceptor>) Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.AdvancedCache.removeInterceptor(int) Since 9.0, use AdvancedCache.getAsyncInterceptorChain() instead.
org.infinispan.configuration.global.GlobalConfigurationChildBuilder.replicationQueueThreadPool() Since 9.0, no longer used.
org.infinispan.configuration.global.GlobalConfigurationBuilder.replicationQueueThreadPool() Since 9.0, no longer used.
org.infinispan.configuration.global.GlobalConfiguration.replicationQueueThreadPool() Since 9.0, no longer used.
org.infinispan.configuration.cache.SyncConfiguration.replTimeout() Since 9.0, please use ClusteringConfiguration#replTimeout() instead.
org.infinispan.configuration.cache.SyncConfigurationBuilder.replTimeout(long) Since 9.0, please use ClusteringConfigurationBuilder.remoteTimeout(long).
org.infinispan.configuration.cache.SyncConfiguration.replTimeout(long) Since 9.0, please use ClusteringConfiguration#replTimeout(long) instead.
org.infinispan.configuration.cache.SyncConfigurationBuilder.replTimeout(long, TimeUnit) Since 9.0, please use ClusteringConfigurationBuilder.remoteTimeout(long, TimeUnit).
org.infinispan.configuration.global.GlobalSecurityConfigurationChildBuilder.securityCacheTimeout(long) Use GlobalSecurityConfigurationChildBuilder.securityCacheTimeout(long, TimeUnit) instead
org.infinispan.configuration.cache.AsyncStoreConfiguration.shutdownTimeout()
org.infinispan.configuration.cache.AsyncStoreConfigurationBuilder.shutdownTimeout(long)
org.infinispan.configuration.cache.AsyncStoreConfiguration.shutdownTimeout(long)
org.infinispan.configuration.cache.AsyncStoreConfigurationBuilder.shutdownTimeout(long, TimeUnit)
org.infinispan.configuration.cache.StoreConfigurationChildBuilder.singleton() Singleton writers will be removed in 10.0. If it is desirable that all nodes don't write to the underlying store then a shared store should be used instead, as this only performs store writes at a key's primary owner.
org.infinispan.configuration.cache.StoreConfiguration.singletonStore() Singleton writers will be removed in 10.0. If it is desirable that all nodes don't write to the underlying store then a shared store should be used instead, as this only performs store writes at a key's primary owner.
org.infinispan.configuration.cache.StoreAsBinaryConfiguration.storeKeysAsBinary() when store as binary is enabled, keys are always stored as binary
org.infinispan.configuration.cache.StoreAsBinaryConfigurationBuilder.storeKeysAsBinary(boolean) No longer supported, keys and values are both enabled if store as binary is
org.infinispan.configuration.cache.StoreAsBinaryConfiguration.storeValuesAsBinary() when store as binary is enabled, values are always stored as binary
org.infinispan.configuration.cache.StoreAsBinaryConfigurationBuilder.storeValuesAsBinary(boolean) No longer supported, keys and values are both enabled if store as binary is
org.infinispan.configuration.global.TransportConfiguration.strictPeerToPeer() Since 6.0, strictPeerToPeer is ignored and asymmetric clusters are always allowed.
org.infinispan.configuration.global.TransportConfigurationBuilder.strictPeerToPeer(Boolean) Since 6.0, strictPeerToPeer is ignored and asymmetric clusters are always allowed.
org.infinispan.configuration.cache.LockingConfiguration.supportsConcurrentUpdates() this option is always true and cannot be modified since version 5.3
org.infinispan.configuration.cache.LockingConfigurationBuilder.supportsConcurrentUpdates(boolean)
org.infinispan.configuration.cache.ClusteringConfigurationChildBuilder.sync() Since 9.0, the replTimeout attribute is now in ClusteringConfigurationBuilder.
org.infinispan.configuration.cache.ClusteringConfiguration.sync() Since 9.0, the replTimeout attribute is now in ClusteringConfiguration.
org.infinispan.configuration.cache.TransactionConfiguration.syncCommitPhase(boolean) The syncRollbackPhase setting can no longer be modified at runtime. It must be the same on all nodes.
org.infinispan.configuration.cache.TransactionConfiguration.syncRollbackPhase(boolean) The syncRollbackPhase setting can no longer be modified at runtime. It must be the same on all nodes.
org.infinispan.query.dsl.FilterConditionContext.toBuilder() To be removed in Infinispan 10.0 without replacement.
org.infinispan.configuration.cache.TransactionConfiguration.useEagerLocking()
org.infinispan.configuration.cache.TransactionConfigurationBuilder.useEagerLocking(boolean) Starting with Infinispan 5.1 eager locking is replaced with pessimistic locking and can be enforced by setting transaction's locking mode to PESSIMISTIC.
org.infinispan.configuration.cache.TransactionConfiguration.useEagerLocking(boolean)
org.infinispan.AdvancedCache.with(ClassLoader) A cache manager, and all caches within it, can only have one classloader associated to it, so it's no longer possible to read cached data with a different classloader.

Deprecated Constructors

Constructor and Description
org.infinispan.configuration.cache.AbstractStoreConfiguration(boolean, boolean, boolean, AsyncStoreConfiguration, SingletonStoreConfiguration, boolean, boolean, Properties) Use {@link AbstractStoreConfiguration#AbstractStoreConfiguration(AttributeSet, AsyncStoreConfiguration, SingletonStoreConfiguration) instead
org.infinispan.configuration.cache.AbstractStoreConfigurationBuilder(PersistenceConfigurationBuilder) Use AbstractStoreConfigurationBuilder.AbstractStoreConfigurationBuilder(PersistenceConfigurationBuilder, AttributeSet) instead
org.infinispan.commons.configuration.AbstractTypedPropertiesConfiguration(Properties) use AbstractTypedPropertiesConfiguration.AbstractTypedPropertiesConfiguration(AttributeSet) instead
org.infinispan.commons.CacheConfigurationException(String, String)
org.infinispan.manager.DefaultCacheManager(String, String, String, boolean)
org.infinispan.client.hotrod.exceptions.RemoteIllegalLifecycleStateException(String, long, short)

Deprecated Enum Constants

Enum Constant and Description
org.infinispan.eviction.EvictionStrategy.FIFO