org.apache.slider.core.zk

Class ZKIntegration

java.lang.Object

org.apache.slider.core.zk.ZKIntegration

All Implemented Interfaces:

Closeable, AutoCloseable, org.apache.zookeeper.Watcher

public class ZKIntegration
extends Object
implements org.apache.zookeeper.Watcher, Closeable

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.zookeeper.Watcher

org.apache.zookeeper.Watcher.Event

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	log
static int	SESSION_TIMEOUT
static String	SVC_SLIDER
static String	SVC_SLIDER_USERS
static String	ZK_SERVICES Base path for services
static String	ZK_SLIDER Base path for all Slider references
static String	ZK_USERS
static List<String>	ZK_USERS_PATH_LIST

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ZKIntegration(String zkConnection, String username, String clustername, boolean canBeReadOnly, boolean createClusterPath, org.apache.zookeeper.Watcher watchEventHandler, int sessionTimeout)

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
String	createPath(String parent, String entry, List<org.apache.zookeeper.data.ACL> acl, org.apache.zookeeper.CreateMode createMode) Create a path under a parent, don't care if it already exists As the path isn't returned, this isn't the way to create sequentially numbered nodes.
boolean	delete(String path) Delete a node, does not throw an exception if the path is not fond
boolean	deleteRecursive(String path) Recursively delete a node, does not throw exception if any node does not exist.
boolean	exists(String path)
boolean	getAlive()
String	getClusterPath()
List<String>	getClusters() Blocking enum of users
org.apache.zookeeper.data.Stat	getClusterStat()
boolean	getConnected()
String	getConnectionString()
org.apache.zookeeper.ZooKeeper.States	getState()
void	init()
static String	mkClusterPath(String username, String clustername) Build the path to a cluster; exists once the cluster has come up.
void	mkPath(List<String> paths, List<org.apache.zookeeper.data.ACL> acl, org.apache.zookeeper.CreateMode createMode) Recursive path create
static String	mkSliderUserPath(String username) Build the path to a cluster; exists once the cluster has come up.
static ZKIntegration	newInstance(String zkConnection, String username, String clustername, boolean createClusterPath, boolean canBeReadOnly, org.apache.zookeeper.Watcher watchEventHandler, int sessionTimeout) Create an instance bonded to the specific closure
void	process(org.apache.zookeeper.WatchedEvent event) Event handler to notify of state events
org.apache.zookeeper.data.Stat	stat(String path)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

ZK_SERVICES

public static String ZK_SERVICES

Base path for services

ZK_SLIDER

public static String ZK_SLIDER

Base path for all Slider references

ZK_USERS

public static String ZK_USERS

SVC_SLIDER

public static String SVC_SLIDER

SVC_SLIDER_USERS

public static String SVC_SLIDER_USERS

ZK_USERS_PATH_LIST

public static final List<String> ZK_USERS_PATH_LIST

SESSION_TIMEOUT

public static int SESSION_TIMEOUT

log

protected static final org.slf4j.Logger log

Constructor Detail

ZKIntegration

protected ZKIntegration(String zkConnection,
             String username,
             String clustername,
             boolean canBeReadOnly,
             boolean createClusterPath,
             org.apache.zookeeper.Watcher watchEventHandler,
             int sessionTimeout)
                 throws IOException

Throws:

IOException

Method Detail

init

public void init()
          throws IOException

Throws:

IOException

newInstance

public static ZKIntegration newInstance(String zkConnection,
                        String username,
                        String clustername,
                        boolean createClusterPath,
                        boolean canBeReadOnly,
                        org.apache.zookeeper.Watcher watchEventHandler,
                        int sessionTimeout)
                                 throws IOException

Create an instance bonded to the specific closure

Parameters:

zkConnection -

username -

clustername -

canBeReadOnly -

watchEventHandler -

Returns:

the new instance

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getConnectionString

public String getConnectionString()

getClusterPath

public String getClusterPath()

getConnected

public boolean getConnected()

getAlive

public boolean getAlive()

getState

public org.apache.zookeeper.ZooKeeper.States getState()

getClusterStat

public org.apache.zookeeper.data.Stat getClusterStat()
                                              throws org.apache.zookeeper.KeeperException,
                                                     InterruptedException

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

exists

public boolean exists(String path)
               throws org.apache.zookeeper.KeeperException,
                      InterruptedException

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

stat

public org.apache.zookeeper.data.Stat stat(String path)
                                    throws org.apache.zookeeper.KeeperException,
                                           InterruptedException

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

toString

public String toString()

Overrides:

toString in class Object

process

public void process(org.apache.zookeeper.WatchedEvent event)

Event handler to notify of state events

Specified by:

process in interface org.apache.zookeeper.Watcher

Parameters:

event -

createPath

public String createPath(String parent,
                String entry,
                List<org.apache.zookeeper.data.ACL> acl,
                org.apache.zookeeper.CreateMode createMode)
                  throws org.apache.zookeeper.KeeperException,
                         InterruptedException

Create a path under a parent, don't care if it already exists As the path isn't returned, this isn't the way to create sequentially numbered nodes.

Parameters:

parent - parent dir. Must have a trailing / if entry!=null||empty

entry - entry -can be null or "", in which case it is not appended

acl -

createMode -

Returns:

the path if created; null if not

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

mkPath

public void mkPath(List<String> paths,
          List<org.apache.zookeeper.data.ACL> acl,
          org.apache.zookeeper.CreateMode createMode)
            throws org.apache.zookeeper.KeeperException,
                   InterruptedException

Recursive path create

Parameters:

paths - path list

acl - acl list

createMode - create modes

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

getClusters

public List<String> getClusters()
                         throws org.apache.zookeeper.KeeperException,
                                InterruptedException

Blocking enum of users

Returns:

an unordered list of clusters under a user

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

delete

public boolean delete(String path)
               throws InterruptedException,
                      org.apache.zookeeper.KeeperException

Delete a node, does not throw an exception if the path is not fond

Parameters:

path - path to delete

Returns:

true if the path could be deleted, false if there was no node to delete

Throws:

InterruptedException

org.apache.zookeeper.KeeperException

deleteRecursive

public boolean deleteRecursive(String path)
                        throws org.apache.zookeeper.KeeperException,
                               InterruptedException

Recursively delete a node, does not throw exception if any node does not exist.

Parameters:

path -

Returns:

true if delete was successful

Throws:

org.apache.zookeeper.KeeperException

InterruptedException

mkClusterPath

public static String mkClusterPath(String username,
                   String clustername)

Build the path to a cluster; exists once the cluster has come up. Even before that, a ZK watcher could wait for it.

Parameters:

username - user

clustername - name of the cluster

Returns:

a strin

mkSliderUserPath

public static String mkSliderUserPath(String username)

Build the path to a cluster; exists once the cluster has come up. Even before that, a ZK watcher could wait for it.

Parameters:

username - user

Returns:

a string