org.apache.curator.utils

Class EnsurePath

java.lang.Object

org.apache.curator.utils.EnsurePath

Deprecated.

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

@Deprecated
public class EnsurePath
extends Object

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 and 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 and 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 Detail

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 Detail

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.