Deprecated API
Contents
-
Deprecated PackagesPackageDescriptionsince 10.0since 10.1. Will be removed unless a binary protocol encoder/decoder is implemented.
-
Deprecated InterfacesInterfaceDescriptionsince 10.0, will be removed in a future release. Please configure a
SerializationContextInitializerand utilise ProtoStream annotations on Java objects instead, or specify a customMarshallerimplementation via the SerializationConfiguration.since 10.0, will be removed in a future release. Please configure aSerializationContextInitializerand utilise ProtoStream annotations on Java objects instead, or specify a customMarshallerimplementation via the SerializationConfiguration.for internal use onlysince 10.0 - This class is not used internally anymoresince 11.0 with no replacement - no longer usedsince 10.1.3. UseStatisticsConfigurationinstead. This will be removed in next major version.Since 11.0. Will be removed in 14.0, the segment allocation will no longer be customizable.since 11.0. To be removed in 14.0 ISPN-11947.since 10.0since 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.since 11.0 replaced byNonBlockingStoresince 11.0 replaced byNonBlockingStoresince 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. The Ickle query language is now preferred over theQueryBuilder. SeeQueryFactory.create(java.lang.String). TheQueryBuilderand associated context interfaces will be removed in version 11.0.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.Since 10.1.3. This mixes statistics across unrelated caches so the reported numbers don't have too much relevance. Please useStatsorClusterCacheStatsinstead.
-
Deprecated ClassesClassDescriptionsince 12.0. To be removed in Infinispan 14since 12.0. To be removed in Infinispan 14.since 12.0. Will be removed in 14.0. Use
ClassAllowList.since 12.0 with no replacementSince 13.0, please useLazyByteArrayOutputStreaminstead.since 9.3 This class will no longer be public, please useIntSets.immutableSet(IntSet)Since 12, will be removed in version 15.0since 9.3 This class will no longer be public. Please useIntSets.immutableRangeSet(int)instead.since 9.3 This class will no longer be public. Please useIntSetsmethods such asIntSets.mutableEmptySet(),IntSets.mutableCopyFrom(Set)Since 10.0, custom interceptors support will be removed and only modules will be able to define interceptorssince 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.since 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.Since 10.0, custom interceptors support will be removed and only modules will be able to define interceptorsSince 10.0, custom interceptors support will be removed and only modules will be able to define interceptorsSince 10.0, custom interceptors support will be removed and only modules will be able to define interceptorssince 10.1.3. UseStatisticsConfigurationBuilderinstead. This will be removed in next major version.Since 11.0,MemoryConfigurationis used to defined the data container memory eviction and sizing.since 11.0, useMemoryConfigurationBuilderinstead.since 10.1.3 UseGlobalJmxConfigurationinstead. This will be removed in next major version.since 10.1.3. UseGlobalJmxConfigurationBuilderinstead. This will be removed in next major version.since 11.0. UseTransport.localSiteName()since 11.0. The local site name is fetched viaTransport.localSiteName()since 12.0. UseAllowListConfigurationBuilderthrough @SerializationConfigurationBuilder.allowList(). Will be removed in 14.0.since 10.0since 10.0since 10.0since 10.0since 10.0since 10.0since 10.0 requires jboss-marshalling-osgi artifact to be provided at runtime.since 10.0since 10.0since 10.0since 10.0since 10.0since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11947.since 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.since 10.1. Will be removed unless a binary protocol encoder/decoder is implemented.since 10.1. Will be removed unless a binary protocol encoder/decoder is implemented.UseVersioninstead
-
Deprecated EnumsEnumDescriptionsince 11.0, use
ByteQuantityinstead.since 11.0. The indexing mode is automatically detected and not configurable anymore (ignored) and will be completely removed in next major version.Since 11.0. Will be removed in 14.0, no longer used.Since 11.0,MemoryConfiguration.maxCount()andMemoryConfiguration.maxSize()should be used to differentiate between the eviction thresholds.since 10.1. See deprecation note onQueryBuilder.
-
Deprecated Exceptions
-
Deprecated Annotation TypesAnnotation TypeDescriptionsince 10.0, will be removed in a future release. Please configure a
SerializationContextInitializerand utilise ProtoStream annotations on Java objects instead, or specify a customMarshallerimplementation via the SerializationConfiguration.
-
Deprecated FieldsFieldDescriptionSince 14.0, please use
ServerStatistics.APPROXIMATE_ENTRIESSince 13.0, please useServerStatistics.STORESinstead.since 11.0since 11.0Since 13.0, will be removed in 16.0Since 9.4, useVersion.getVersionShort()instead.
-
Deprecated MethodsMethodDescriptionSince 10.0, will be removed without a replacementSince 10.0, with no public API replacementSince 10.1, will be removed without a replacementSince 9.4, unmarshalling always uses the classloader from the global configuration.Since 12.1, to be removed in a future version.Since 12.1, to be removed in a future version.Since 12.1, to be removed in a future version.Use
AdvancedCache.withMediaType(MediaType, MediaType)instead.Since 11.0. To be removed in 14.0, with no replacement.Since 11.0. To be removed in 14.0, with no replacement.since 9.3 This is to be replaced byBaseCacheStream.filterKeySegments(IntSet)This method requires boxing for each segment. Please useBaseCacheStream.SegmentCompletionListener.accept(Supplier)insteadThis is to be replaced byCacheStream.filterKeySegments(IntSet)Since 12.0, does nothing and will be removed in 15.0org.infinispan.client.hotrod.configuration.AbstractConfigurationChildBuilder.protocolVersion(String) Since 12.0, does nothing and will be removed in 15.0UseConfiguration.getClassAllowList()instead. To be removed in 14.0.Since 12.0, does nothing and will be removed in 15.0UseConfiguration.serialAllowList()instead. To be removed in 14.0.since 12.0. To be removed in Infinispan 14.Since 12.0, does nothing and will be removed in 15.0Since 12.0, does nothing and will be removed in 15.0since 11.0. To be removed in 14.0. UseRemoteCacheConfigurationBuilder.nearCacheMode(NearCacheMode)andRemoteCacheConfigurationBuilder.nearCacheMaxEntries(int)instead.UseConfigurationBuilder.version(ProtocolVersion)instead.Since 12.0, does nothing and will be removed in 15.0UseConfigurationChildBuilder.addJavaSerialAllowList(String...)instead. To be removed in 14.0.since 9.0. To be removed in 12.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(javax.net.ssl.SSLContext))Since 12.0, does nothing and will be removed in 15.0since 9.0. To be removed in 12.0. UseConfigurationChildBuilder.version(ProtocolVersion)instead.Since 12.0, does nothing and will be removed in 15.0useRemoteCacheConfigurationBuilder.nearCacheMode(NearCacheMode)to enable near-caching per-cacheuseRemoteCacheConfigurationBuilder.nearCacheMode(NearCacheMode)to enable near-caching per-cachesince 12.0. To be removed in Infinispan 14. UseRemoteCacheConfigurationBuilder.transactionManagerLookup(TransactionManagerLookup)instead.since 9.3since 12.0 to be removed in 15.0. UseSslConfigurationBuilder.trustStoreFileName(String)and pass pem toSslConfigurationBuilder.trustStoreType(String).since 12.0. To be removed in Infinispan 14. UseConfigurationBuilder.transactionTimeout(long, TimeUnit)since 12.0. To be removed in Infinispan 14. UseRemoteCacheConfigurationBuilder.transactionManagerLookup(TransactionManagerLookup)since 12.0. To be removed in Infinispan 14. UseRemoteCacheConfigurationBuilder.transactionMode(TransactionMode)Since 12.0, will be removed in 15.0Since 12.0, will be removed in 15.0since 10.1.2. Will be removed in 11 without replacement.Since 10.0, with no replacementuseRemoteCache.serverStatistics()insteadsince 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 11.0. UseConfigurationBuilder.remoteCache(String)to configure the cache and thenRemoteCacheContainer.getCache(String)to obtain it.since 10.0 - please implementAbstractSegmentedStoreConfiguration.newConfigurationFrom(int, InitializationContext).since 11.0 with no replacement as the thread pool is no longer usedsince 11.0 with no replacement as the thread pool is no longer usedUse a named cache withBackupForBuilder.remoteCache(String)instead.Since 10.0, custom interceptors support will be removed and only modules will be able to define interceptorssince 10.1.3 useConfiguration.statistics()instead. This will be removed in next major version.Since 10.0, custom interceptors support will be removed and only modules will be able to define interceptorsSince 10.0, custom interceptors support will be removed and only modules will be able to define interceptorssince 10.1.3 useConfigurationChildBuilder.statistics()instead. This will be removed in next major version.Since 10.0, custom interceptors support will be removed and only modules will be able to define interceptorsSince 11.0. Will be removed in 14.0, the segment allocation will no longer be customizable.Since 11.0. Will be removed in 14.0, the segment allocation will no longer be customizable.UseIndexingConfiguration.enabled()} insteadin 10.1. Equivalent to a simple equality comparison toIndex.PRIMARY_OWNER.Since 11.0, with no replacement.Since 11. This configuration will be removed in next major version as the index mode is calculated automatically.since 11. Usages should be converted toIndexingConfiguration.indexedEntityTypes()as this method will be removed in next major version.Since 11.0 with no replacement; to be removed in next major version.Since 12.0, indexing behaviour is defined byIndexingConfiguration.writer()andIndexingConfiguration.reader().Since 12.0, please useIndexingConfigurationBuilder.writer()andIndexingConfigurationBuilder.reader()to define indexing behavior.Since 11.0, with no replacement.Since 11.0 with no replacement.Since 11.0. This configuration will be removed in next major version as the index mode is calculated automatically.Since 12.0, pleaseIndexingConfigurationBuilder.writer()andIndexingConfigurationBuilder.reader()to define indexing behavior.Since 12.0, pleaseIndexingConfigurationBuilder.writer()andIndexingConfigurationBuilder.reader()to define indexing behavior.since 10.1.3. This method will be removed in a future version.since 10.1.3. This method will be removed in a future version.Since 11.0, useMemoryConfiguration.whenFull()Since 11.0, useMemoryConfiguration.maxCount()orMemoryConfiguration.maxSize()to obtain either the maximum number of entries or the maximum size of the data container.Since 11.0, useMemoryConfiguration.maxCount()orMemoryConfiguration.maxSize()to obtain either the maximum number of entries or the maximum size of the data container.Since 11.0, useMemoryConfiguration.maxCount(long)orMemoryConfiguration.maxSize(String)to dynamically configure the maximum number of entries or the maximum size of the data container.UseMemoryConfiguration.storage()instead.Since 11.0, useMemoryConfigurationBuilder.whenFull()instead.Since 11.0, useMemoryConfigurationBuilder.whenFull(EvictionStrategy)instead.since 11.0, @seeMemoryConfigurationBuilder.evictionType(EvictionType)since 11.0, useMemoryConfigurationBuilder.maxCount(long)orMemoryConfigurationBuilder.maxSize(String)to define data container bounds by size or by count.Since 11.0, use eitherMemoryConfigurationBuilder.maxSize()orMemoryConfigurationBuilder.maxCount().Since 11.0, useMemoryConfigurationBuilder.maxSize(String)to define the size in bytes orMemoryConfigurationBuilder.maxCount(long)to define the number of entries.Since 11.0, useMemoryConfigurationBuilder.storage()instead.Since 11.0, useMemoryConfigurationBuilder.storage(StorageType)instead.since 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.since 13.0. To be removed in 14.0 has been replaced byPersistenceConfigurationBuilder.addSoftIndexFileStore()Since 13.0, will be removed in 16.0.Since 13.0, will be removed in 16.0Since 12.1, the attribute was never writablesince 10.1.3. This method will be removed in a future version.since 10.1.3. This method will be removed in a future version.org.infinispan.configuration.global.CacheContainerConfigurationBuilder.stateTransferExecutor(String) Since 10.1, no longer used.Since 10.1, no longer used.Since 10.1.3. UseCacheContainerConfigurationBuilder.statistics(boolean)instead.Since 11.0, no longer used.Since 11.0, no longer used.Since 10.1.3. UseGlobalConfiguration.jmx()instead. This will be removed in next major version.Since 11.0, no longer used.Since 11.0, no longer used.Since 10.1, no longer used.Since 10.1, no longer used.Since 10.1, no longer used.Since 10.1.3. UseGlobalConfigurationChildBuilder.jmx()instead. This will be removed in next major version.Since 10.1. please useGlobalConfiguration.cacheManagerName()instead.Since 10.1. please useGlobalConfiguration.cacheManagerName()instead.org.infinispan.configuration.global.GlobalJmxStatisticsConfigurationBuilder.cacheManagerName(String) Since 10.1.3, please useGlobalJmxStatisticsConfigurationBuilder.domain(String)instead.since 10.0,AdvancedExternalizer's will be removed in a future release.since 10.0,AdvancedExternalizer's will be removed in a future release. Please utilise ProtoStream annotations on Java objects instead by configuring aSerializationContextInitializerviaSerializationConfigurationBuilder.addContextInitializer(SerializationContextInitializer), or specifying a custom marshaller for user types viaSerializationConfigurationBuilder.marshaller(Marshaller).since 10.0,AdvancedExternalizer's will be removed in a future release. Please utilise ProtoStream annotations on Java objects instead by configuring aSerializationContextInitializerviaSerializationConfigurationBuilder.addContextInitializer(SerializationContextInitializer), or specifying a custom marshaller for user types viaSerializationConfigurationBuilder.marshaller(Marshaller).since 10.0,AdvancedExternalizer's will be removed in a future release. Please utilise ProtoStream annotations on Java objects instead by configuring aSerializationContextInitializerviaSerializationConfigurationBuilder.addContextInitializer(SerializationContextInitializer), or specifying a custom marshaller for user types viaSerializationConfigurationBuilder.marshaller(Marshaller).since 12.0. UseSerializationConfigurationBuilder.allowList()instead. To be removed in 14.0.Since 10.1, no longer used.Since 11.0, no longer used.Since 10.1, no longer used.Since 11.0, no longer used.since 10.1 - Please useDataContainer.peek(Object)instead.Since 9.3, please useEntryLookup.forEachEntry(BiConsumer)orEntryLookup.lookedUpEntriesCount()instead.Since 11, to be removed in 14 with no replacementsince 11.0. hashFunction is ignored, useConsistentHashFactory.create(int, int, List, Map)instead.Since 11.0, to be removed in 14.0. Please useDistributionManager.getCacheTopology()instead.Since 11.0, to be removed in 14.0. Please useDistributionManager.getCacheTopology()instead.Internal only.Since 9.1since 9.3 please useLocalizedCacheTopology.getSegmentDistribution(int)instead.org.infinispan.expiration.ExpirationManager.handleInMemoryExpiration(InternalCacheEntry<K, V>, long) since 9.3 this method is not intended for external usesince 9.3 this method is not intended for external usesince 9.3 this method is not intended for external usesince 9.3 There is no reason for this method and is implementation specificsince 9.3 There is no reason for this method and is implementation specificsince 12.0, useLocalConfigurationStorage.loadAllCaches()insteadThis is to be replaced byLockedStream.filterKeySegments(IntSet)Since 10.0, with no public API replacementSince 10.1.3. This mixes statistics across unrelated caches so the reported numbers don't have too much relevance.Since 10.0, please useEmbeddedCacheManager.getAddress(),EmbeddedCacheManager.getMembers(),EmbeddedCacheManager.getCoordinator()Since 9.2, obtain aCacheContainerAdmininstance usingEmbeddedCacheManager.administration()and invoke theCacheContainerAdmin.removeCache(String)methodSince 9.0Since 10.0, with no replacementSince 13.0 with no replacementDeprecated since 13.0 with no replacementplease useAbstractStoreConfiguration.maxBatchSize()instead.Please useAbstractStoreConfigurationBuilder.maxBatchSize(int)instead.since 9.4 This method references PersistenceManager, which isn't a public classsince 9.4 This method references PersistenceManager, which isn't a public classsince 9.4 This method references PersistenceManager, which isn't a public classsince 9.4 This method references PersistenceManager, which isn't a public classSince 12.0, does nothing and will be removed in 15.0Since 12.0, does nothing and will be removed in 15.0since 10.0. This method has no effectsince 10.0. This method has no effectsince 10.0. This method has no effectsince 10.0. This method has no effectsince 12.0 - Automatic media type detection in remote store makes this option redundantSince 12.0, does nothing and will be removed in 15.0since 12.0 - This option can still be needed when retrieving from a preexisting remote cachesince 10.0. This method always returns nullSince 12.0, does nothing and will be removed in 15.0org.infinispan.persistence.remote.configuration.RemoteStoreConfigurationBuilder.keySizeEstimate(int) Since 12.0, does nothing and will be removed in 15.0Since 12.0, does nothing and will be removed in 15.0Since 12.0, does nothing and will be removed in 15.0since 10.0. This method has no effectsince 10.0. This method has no effectSince 12.0, does nothing and will be removed in 15.0Since 12.0, no longer used. Will be removed in 15.0There is no more queue inRocksDBStoreSince 12.0, no longer used. Will be removed in 15.0Since 10.1, there is no more queue inRocksDBStoresince 11.0 - Please useInitializationContext.getBlockingManager()()} orInitializationContext.getNonBlockingExecutor()insteadTo be removed in Infinispan 10.0 without replacement.since 11.0. This method will be removed in next major version. To find out if a query uses projections useQuery.hasProjections()since 10.1. This will be removed in 12. It's closest replacement isQueryResult.hitCount()which returns an optional long.since 11.0, useQueryResult.list()instead.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 10.1. See deprecation note onQueryBuilder.since 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.since 11.0. To be removed in 14.0 ISPN-11864 with no direct replacement.Since 14.0, please useStats.getAverageWriteTimeNanos()instead.Since 14.0, please useStats.getAverageReadTimeNanos()instead.Since 14.0, please useStats.getApproximateEntries()orStats.getApproximateEntriesUnique()instead.Since 14.0, please useStats.getApproximateEntriesInMemory()instead.Since 13.0, please useStats.getStores()instead
-
Deprecated ConstructorsConstructorDescriptionSince 11.0, please use
DefaultCacheManager(ConfigurationBuilderHolder, boolean)instead.Since 11.0, please useDefaultCacheManager(ConfigurationBuilderHolder, boolean)instead.Since 11.0, please useDefaultCacheManager(ConfigurationBuilderHolder, boolean)instead.Since 11.0, please useDefaultCacheManager(ConfigurationBuilderHolder, boolean)instead.
-
Deprecated Enum ConstantsEnum ConstantDescriptionconfigurations are now always permanent by default. Use the
CacheContainerAdmin.AdminFlag.VOLATILEflag to obtain the opposite behaviour.This mode is no longer supported since version 11.0. A configuration error will be raised if encountered.since 11.0, with no replacement. UseStorageType.HEAPand the cache'sEncodingConfigurationto define aMediaTypethat is byte[] or primitive based.since 11.0, useStorageType.HEAPinstead.Since 10.0, not in use.Since 10.0, not in use.Since 12.0, will be removed in 15.0Since 12.0, will be removed in 15.0