org.apache.hadoop.hbase.zookeeper

类 ZKWatcher

java.lang.Object

org.apache.hadoop.hbase.zookeeper.ZKWatcher

所有已实现的接口:

Closeable, AutoCloseable, Abortable, org.apache.zookeeper.Watcher

@InterfaceAudience.Private
public class ZKWatcher
extends Object
implements org.apache.zookeeper.Watcher, Abortable, Closeable

Acts as the single ZooKeeper Watcher. One instance of this is instantiated for each Master, RegionServer, and client process.

This is the only class that implements Watcher. Other internal classes which need to be notified of ZooKeeper events must register with the local instance of this watcher via registerListener(org.apache.hadoop.hbase.zookeeper.ZKListener).

This class also holds and manages the connection to ZooKeeper. Code to deal with connection related events and exceptions are handled here.

嵌套类概要

从接口继承的嵌套类/接口 org.apache.zookeeper.Watcher

org.apache.zookeeper.Watcher.Event

字段概要

字段

限定符和类型	字段和说明
protected Abortable	abortable
CountDownLatch	saslLatch
ZNodePaths	znodePaths

构造器概要

构造器

构造器和说明
ZKWatcher(org.apache.hadoop.conf.Configuration conf, String identifier, Abortable abortable) Instantiate a ZooKeeper connection and watcher.
ZKWatcher(org.apache.hadoop.conf.Configuration conf, String identifier, Abortable abortable, boolean canCreateBaseZNode) Instantiate a ZooKeeper connection and watcher.

方法概要

限定符和类型	方法和说明
void	abort(String why, Throwable e)
void	checkAndSetZNodeAcls() On master start, we check the znode ACLs under the root directory and set the ACLs properly if needed.
void	close() Close the connection to ZooKeeper.
org.apache.hadoop.conf.Configuration	getConfiguration()
List<ZKListener>	getListeners() Get a copy of current registered listeners
List<String>	getMetaReplicaNodes() Get the znodes corresponding to the meta replicas from ZK
int	getNumberOfListeners()
String	getQuorum() Get the quorum address of this instance.
RecoverableZooKeeper	getRecoverableZooKeeper() Get the connection to ZooKeeper.
ZNodePaths	getZNodePaths() Get the znodePaths.
void	interruptedException(InterruptedException ie) Handles InterruptedExceptions in client calls.
void	interruptedExceptionNoThrow(InterruptedException ie, boolean throwLater) Log the InterruptedException and interrupt current thread
boolean	isAborted()
static boolean	isSuperUserId(String[] superUsers, org.apache.zookeeper.data.Id id)
void	keeperException(org.apache.zookeeper.KeeperException ke) Handles KeeperExceptions in client calls.
String	prefix(String str) Adds this instance's identifier as a prefix to the passed str
void	process(org.apache.zookeeper.WatchedEvent event) Method called from ZooKeeper for events and connection status.
void	reconnectAfterExpiration()
void	registerListener(ZKListener listener) Register the specified listener to receive ZooKeeper events.
void	registerListenerFirst(ZKListener listener) Register the specified listener to receive ZooKeeper events and add it as the first in the list of current listeners.
void	sync(String path) Forces a synchronization of this ZooKeeper client connection.
String	toString()
void	unregisterAllListeners() Clean all existing listeners
void	unregisterListener(ZKListener listener)

从类继承的方法 java.lang.Object

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

字段详细资料

abortable

protected Abortable abortable

znodePaths

public final ZNodePaths znodePaths

saslLatch

public CountDownLatch saslLatch

构造器详细资料

ZKWatcher

public ZKWatcher(org.apache.hadoop.conf.Configuration conf,
                 String identifier,
                 Abortable abortable)
          throws ZooKeeperConnectionException,
                 IOException

Instantiate a ZooKeeper connection and watcher.

参数:

identifier - string that is passed to RecoverableZookeeper to be used as identifier for this instance. Use null for default.

抛出:

IOException - if the connection to ZooKeeper fails

ZooKeeperConnectionException

ZKWatcher

public ZKWatcher(org.apache.hadoop.conf.Configuration conf,
                 String identifier,
                 Abortable abortable,
                 boolean canCreateBaseZNode)
          throws IOException,
                 ZooKeeperConnectionException

Instantiate a ZooKeeper connection and watcher.

参数:

conf - the configuration to use

identifier - string that is passed to RecoverableZookeeper to be used as identifier for this instance. Use null for default.

abortable - Can be null if there is on error there is no host to abort: e.g. client context.

canCreateBaseZNode - true if a base ZNode can be created

抛出:

IOException - if the connection to ZooKeeper fails

ZooKeeperConnectionException

方法详细资料

checkAndSetZNodeAcls

public void checkAndSetZNodeAcls()

On master start, we check the znode ACLs under the root directory and set the ACLs properly if needed. If the cluster goes from an unsecure setup to a secure setup, this step is needed so that the existing znodes created with open permissions are now changed with restrictive perms.

isSuperUserId

public static boolean isSuperUserId(String[] superUsers,
                                    org.apache.zookeeper.data.Id id)

toString

public String toString()

覆盖:

toString 在类中 Object

prefix

public String prefix(String str)

Adds this instance's identifier as a prefix to the passed str

参数:

str - String to amend.

返回:

A new string with this instance's identifier as prefix: e.g. if passed 'hello world', the returned string could be

getMetaReplicaNodes

public List<String> getMetaReplicaNodes()
                                 throws org.apache.zookeeper.KeeperException

Get the znodes corresponding to the meta replicas from ZK

返回:

list of znodes

抛出:

org.apache.zookeeper.KeeperException - if a ZooKeeper operation fails

registerListener

public void registerListener(ZKListener listener)

Register the specified listener to receive ZooKeeper events.

参数:

listener - the listener to register

registerListenerFirst

public void registerListenerFirst(ZKListener listener)

Register the specified listener to receive ZooKeeper events and add it as the first in the list of current listeners.

参数:

listener - the listener to register

unregisterListener

public void unregisterListener(ZKListener listener)

unregisterAllListeners

public void unregisterAllListeners()

Clean all existing listeners

getListeners

public List<ZKListener> getListeners()

Get a copy of current registered listeners

getNumberOfListeners

public int getNumberOfListeners()

返回:

The number of currently registered listeners

getRecoverableZooKeeper

public RecoverableZooKeeper getRecoverableZooKeeper()

Get the connection to ZooKeeper.

返回:

connection reference to zookeeper

reconnectAfterExpiration

public void reconnectAfterExpiration()
                              throws IOException,
                                     org.apache.zookeeper.KeeperException,
                                     InterruptedException

抛出:

IOException

org.apache.zookeeper.KeeperException

InterruptedException

getQuorum

public String getQuorum()

Get the quorum address of this instance.

返回:

quorum string of this zookeeper connection instance

getZNodePaths

public ZNodePaths getZNodePaths()

Get the znodePaths.

Mainly used for mocking as mockito can not mock a field access.

process

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

Method called from ZooKeeper for events and connection status.

Valid events are passed along to listeners. Connection status changes are dealt with locally.

指定者:

process 在接口中 org.apache.zookeeper.Watcher

sync

public void sync(String path)
          throws org.apache.zookeeper.KeeperException

Forces a synchronization of this ZooKeeper client connection.

Executing this method before running other methods will ensure that the subsequent operations are up-to-date and consistent as of the time that the sync is complete.

This is used for compareAndSwap type operations where we need to read the data of an existing node and delete or transition that node, utilizing the previously read version and data. We want to ensure that the version read is up-to-date from when we begin the operation.

抛出:

org.apache.zookeeper.KeeperException

keeperException

public void keeperException(org.apache.zookeeper.KeeperException ke)
                     throws org.apache.zookeeper.KeeperException

Handles KeeperExceptions in client calls.

This may be temporary but for now this gives one place to deal with these.

TODO: Currently this method rethrows the exception to let the caller handle

参数:

ke - the exception to rethrow

抛出:

org.apache.zookeeper.KeeperException - if a ZooKeeper operation fails

interruptedException

public void interruptedException(InterruptedException ie)
                          throws org.apache.zookeeper.KeeperException

Handles InterruptedExceptions in client calls.

参数:

ie - the InterruptedException instance thrown

抛出:

org.apache.zookeeper.KeeperException - the exception to throw, transformed from the InterruptedException

interruptedExceptionNoThrow

public void interruptedExceptionNoThrow(InterruptedException ie,
                                        boolean throwLater)

Log the InterruptedException and interrupt current thread

参数:

ie - The IterruptedException to log

throwLater - Whether we will throw the exception latter

close

public void close()

Close the connection to ZooKeeper.

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

getConfiguration

public org.apache.hadoop.conf.Configuration getConfiguration()

abort

public void abort(String why,
                  Throwable e)

指定者:

abort 在接口中 Abortable

isAborted

public boolean isAborted()

指定者:

isAborted 在接口中 Abortable