Package org.apache.curator.utils

Class EnsurePath

java.lang.Object

org.apache.curator.utils.EnsurePath

@Deprecated
public class EnsurePath
extends Object

Deprecated.

Since 2.9.0 - Prefer CuratorFramework.create().creatingParentContainersIfNeeded() or CuratorFramework.exists().creatingParentContainersIfNeeded()

Utility to ensure that a particular path is created.

The first time it is used, a synchronized call to ZKPaths.mkdirs(ZooKeeper, String) is made to ensure that the entire path has been created (with an empty byte array if needed). Subsequent calls with the instance are un-synchronized NOPs.

Usage:

         EnsurePath       ensurePath = new EnsurePath(aFullPathToEnsure);
         ...
         String           nodePath = aFullPathToEnsure + "/foo";
         ensurePath.ensure(zk);   // first time syncs and creates if needed
         zk.create(nodePath, ...);
         ...
         ensurePath.ensure(zk);   // subsequent times are NOPs
         zk.create(nodePath, ...);
 

Constructor Summary

Constructors

Modifier	Constructor	Description
	EnsurePath(String path)	Deprecated.
protected	EnsurePath(String path, AtomicReference<org.apache.curator.utils.EnsurePath.Helper> helper, boolean makeLastNode, InternalACLProvider aclProvider)	Deprecated.
	EnsurePath(String path, InternalACLProvider aclProvider)	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected boolean	asContainers()	Deprecated.
void	ensure(CuratorZookeeperClient client)	Deprecated. First time, synchronizes and makes sure all nodes in the path are created.
EnsurePath	excludingLast()	Deprecated. Returns a view of this EnsurePath instance that does not make the last node.
String	getPath()	Deprecated. Returns the path being Ensured

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

EnsurePath

public EnsurePath(String path)

Deprecated.

Parameters:

path - the full path to ensure

EnsurePath

public EnsurePath(String path,
 InternalACLProvider aclProvider)

Deprecated.

Parameters:

path - the full path to ensure

aclProvider - if not null, the ACL provider to use when creating parent nodes

EnsurePath

protected EnsurePath(String path,
 AtomicReference<org.apache.curator.utils.EnsurePath.Helper> helper,
 boolean makeLastNode,
 InternalACLProvider aclProvider)

Deprecated.

Method Details

ensure

public void ensure(CuratorZookeeperClient client)
            throws Exception

Deprecated.

First time, synchronizes and makes sure all nodes in the path are created. Subsequent calls with this instance are NOPs.

Parameters:

client - ZK client

Throws:

Exception - ZK errors

excludingLast

public EnsurePath excludingLast()

Deprecated.

Returns a view of this EnsurePath instance that does not make the last node. i.e. if the path is "/a/b/c" only "/a/b" will be ensured

Returns:

view

getPath

public String getPath()

Deprecated.

Returns the path being Ensured

Returns:

the path being ensured

asContainers

protected boolean asContainers()

Deprecated.