Deprecated API

Contents

• Interfaces
• Classes
• Enum Classes
• Methods
• Constructors

Deprecated Interfaces

Interface	Description
org.apache.curator.framework.api.transaction.CuratorTransaction	Use CuratorFramework.transaction()

Deprecated Classes

Class	Description
org.apache.curator.framework.recipes.cache.NodeCache	replace by CuratorCache
org.apache.curator.framework.recipes.cache.PathChildrenCache	replace by CuratorCache
org.apache.curator.framework.recipes.cache.TreeCache	replace by CuratorCache
org.apache.curator.framework.recipes.locks.InterProcessSemaphore	Use InterProcessSemaphoreV2 instead of this class. It uses a better algorithm.
org.apache.curator.framework.recipes.nodes.PersistentEphemeralNode	This has been replaced with the more general PersistentNode
org.apache.curator.utils.EnsurePath	Since 2.9.0 - Prefer CuratorFramework.create().creatingParentContainersIfNeeded() or CuratorFramework.exists().creatingParentContainersIfNeeded()

Deprecated Enum Classes

Enum Class	Description
org.apache.curator.framework.recipes.cache.PathChildrenCacheMode	no longer used. Instead use either PathChildrenCache(CuratorFramework, String, boolean) or PathChildrenCache(CuratorFramework, String, boolean, ThreadFactory)
org.apache.curator.framework.recipes.nodes.PersistentEphemeralNode.Mode	This has been replaced with the more general PersistentNode

Deprecated Methods

Method	Description
org.apache.curator.drivers.AdvancedTracerDriver.addCount(String, int)
org.apache.curator.drivers.AdvancedTracerDriver.addTrace(String, long, TimeUnit)
org.apache.curator.framework.api.CreateBuilderMain.withProtectedEphemeralSequential()	this has been generalized to support all create modes. Instead, use: client.create().withProtection().withMode(CreateMode.EPHEMERAL_SEQUENTIAL)...
org.apache.curator.framework.CuratorFramework.clearWatcherReferences(Watcher)	As of ZooKeeper 3.5 Curators recipes will handle removing watcher references when they are no longer used. If you write your own recipe, follow the example of Curator recipes and use CuratorFramework.newWatcherRemoveCuratorFramework() calling WatcherRemoveCuratorFramework.removeWatchers() when closing your instance.
org.apache.curator.framework.CuratorFramework.inTransaction()	use CuratorFramework.transaction() instead
org.apache.curator.framework.CuratorFramework.isStarted()	use CuratorFramework.getState() instead
org.apache.curator.framework.CuratorFramework.newNamespaceAwareEnsurePath(String)	Since 2.9.0 - prefer CreateBuilderMain.creatingParentContainersIfNeeded(), ExistsBuilder.creatingParentContainersIfNeeded() or CuratorFramework.createContainers(String)
org.apache.curator.framework.CuratorFramework.nonNamespaceView()	Since 2.9.0 - use CuratorFramework.usingNamespace(java.lang.String) passing null
org.apache.curator.framework.CuratorFramework.sync(String, Object)	use CuratorFramework.sync() instead
org.apache.curator.framework.CuratorFramework.watches()	use CuratorFramework.watchers() in ZooKeeper 3.6+
org.apache.curator.framework.CuratorFrameworkFactory.Builder.getAuthScheme()
org.apache.curator.framework.CuratorFrameworkFactory.Builder.getAuthValue()
org.apache.curator.framework.imps.CuratorFrameworkImpl.isStarted()
org.apache.curator.framework.imps.CuratorFrameworkImpl.nonNamespaceView()
org.apache.curator.framework.recipes.cache.PathChildrenCache.start(boolean)	use PathChildrenCache.start(StartMode)
org.apache.curator.framework.recipes.shared.SharedCount.trySetCount(int)	use SharedCount.trySetCount(VersionedValue, int) for stronger atomicity guarantees. Even if this object's internal state is up-to-date, the caller has no way to ensure that they've read the most recently seen count.
org.apache.curator.framework.recipes.shared.SharedValue.trySetValue(byte[])	use SharedValue.trySetValue(VersionedValue, byte[]) for stronger atomicity guarantees. Even if this object's internal state is up-to-date, the caller has no way to ensure that they've read the most recently seen value.
org.apache.curator.test.InstanceSpec.getConnectString()	use TestingServer.getConnectString() or TestingCluster.getConnectString() instead
org.apache.curator.test.KillSession.kill(ZooKeeper, String)	use KillSession.kill(ZooKeeper) instead
org.apache.curator.test.KillSession.kill(ZooKeeper, String, int)	use KillSession.kill(ZooKeeper) instead
org.apache.curator.x.discovery.server.rest.DiscoveryResource.getDeprecated(String, String)
org.apache.curator.x.discovery.ServiceCacheBuilder.threadFactory(ThreadFactory)	use ServiceCacheBuilder.executorService(ExecutorService) instead
org.apache.curator.x.discovery.ServiceProviderBuilder.threadFactory(ThreadFactory)	use ServiceProviderBuilder.executorService(ExecutorService) instead

Deprecated Constructors

Constructor	Description
org.apache.curator.framework.recipes.cache.PathChildrenCache(CuratorFramework, String, PathChildrenCacheMode)	use PathChildrenCache(CuratorFramework, String, boolean) instead
org.apache.curator.framework.recipes.cache.PathChildrenCache(CuratorFramework, String, PathChildrenCacheMode, ThreadFactory)	use PathChildrenCache(CuratorFramework, String, boolean, ThreadFactory) instead
org.apache.curator.framework.recipes.leader.LeaderSelector(CuratorFramework, String, ThreadFactory, Executor, LeaderSelectorListener)	This constructor was poorly thought out. Custom executor is useless. Use this version instead: LeaderSelector(CuratorFramework, String, ExecutorService, LeaderSelectorListener)
org.apache.curator.framework.schema.SchemaViolation(String)	use SchemaViolation(Schema, ViolatorData, String) instance
org.apache.curator.framework.schema.SchemaViolation(Schema, String)	use SchemaViolation(Schema, ViolatorData, String) instance