zookeeper本身就不多说了,这篇文章主要说的是利用java来操作zookeeper,就像利用java来操作mysql数据库一样,java操作mysql数据库需要jar包来作为驱动,自然,操作zookeeper也需要jar包,而这些操作zookeeper的jar包我们有时候也称为java操作zookeeper的客户端,尽管名字叫法不准确,可还是有很多人这样叫。
概括的说,有三种方法比较常用。
01、zookeeper官方提供的原生的api
02、Apache Curator,不用说,这是开源界的雷锋apache提供的
03、zkclient,这家伙也是一个开源的jar包,maven仓库都可以下载的
简单说下三种方式的区别与各自的优劣:
zookeeper自带的客户端是官方提供的,比较底层、使用起来写代码麻烦,很多功能需要自己来实现、不够直接。
Apache Curator是Apache的开源项目,封装了zookeeper自带的客户端,使用相对简便,易于使用。
zkclient是另一个开源的ZooKeeper客户端。
以下分别列出三种方式的maven依赖:
zookeeper原生的api包:
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.6</version>
</dependency>
Apache Curator的Maven地址:
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-framework</artifactId>
<version>2.9.0</version>
</dependency>
zkclient:
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>0.10</version>
</dependency>
具体使用哪个,这要看你的选择了,功能都可以实现,就是方便与不方便而已吧。
这里演示的是通过zookeeper官方提供的zookeeper-3.4.8.jar提供的api来操作zookeeper的示例。
import java.util.List;
import java.util.concurrent.CountDownLatch;
import org.apache.zookeeper.CreateMode;
import org.apache.zookeeper.WatchedEvent;
import org.apache.zookeeper.Watcher;
import org.apache.zookeeper.ZooDefs;
import org.apache.zookeeper.ZooKeeper;
import org.apache.zookeeper.data.Stat;
public class ZookeeperUtils {
private static final String conn = "127.0.0.1:2181";
private static final int sessionTimeout = 30000;
public static void main(String[] args) throws Exception{
ZookeeperUtils zUtils=new ZookeeperUtils();
// zUtils.createChildNode();
// zUtils.createNode();
// zUtils.getNodeData();
zUtils.deleteNode();
}
/**
* 在zookeeper上创建一个节点
*/
public void createNode() throws Exception{
ZooKeeper zk=getInstance();
zk.create("/node1", "node1_data".getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE,
CreateMode.PERSISTENT);
zk.close();
}
/**
* 获取指定节点的数据
*/
public void getNodeData()throws Exception{
ZooKeeper zk=getInstance();
Stat stat=new Stat();
//第二个参数true表示监控/node1节点的数据变化,提现在zk的创建watcher中
byte[] data = zk.getData("/node1", true, stat);
System.out.println("zookeeper节点/node1里面的数据是:"+new String(data));
zk.close();
}
/**
* 修改指定节点的数据
*/
public void updateNodeData()throws Exception{
ZooKeeper zk=getInstance();
//第三个参数是version,传入-1表示忽略版本
zk.setData("/node1", "node1_data_new".getBytes(), -1);
zk.close();
}
/**
* 在已有节点上创建子节点,如果父节点没有那么就不能创建
*/
public void createChildNode() throws Exception{
ZooKeeper zk=getInstance();
zk.create("/node1/child1_1","child1_1_data".getBytes(),
ZooDefs.Ids.OPEN_ACL_UNSAFE,
CreateMode.PERSISTENT);
zk.close();
}
public void getChildNodeData() throws Exception{
ZooKeeper zk=getInstance();
List<String> children = zk.getChildren("/testRoot",new Watcher() {
public void process(WatchedEvent event) {
System.out.println(event);
}
});
System.out.println("子节点:"+children);
}
/**
* 删除指定节点:如果指定节点非空,那么久不能删除,报错:
* Exception in thread "main" org.apache.zookeeper.KeeperException$NotEmptyException:
* KeeperErrorCode = Directory not empty for /node1
at org.apache.zookeeper.KeeperException.create(KeeperException.java:125)
at org.apache.zookeeper.KeeperException.create(KeeperException.java:51)
at org.apache.zookeeper.ZooKeeper.delete(ZooKeeper.java:873)
at ZookeeperUtils.deleteNode(ZookeeperUtils.java:77)
at ZookeeperUtils.main(ZookeeperUtils.java:21)
需要从最里层往外依次删除
*/
public void deleteNode() throws Exception{
ZooKeeper zk=getInstance();
zk.delete("/node1", -1);
zk.close();
}
/**
* 为避免连接还未完成就通过ZooKeeper对象来对zookeeper进行操作,此时会引发异常,
* 通常需要确保Zookeeper对象创建完成后才返回实例,确保的方法是使用倒计时计数器CountDownLatch
* @return
* @throws Exception
*/
public static ZooKeeper getInstance(){
final CountDownLatch connectedSignal = new CountDownLatch(1);
ZooKeeper zk =null;
try {
zk = new ZooKeeper(conn, sessionTimeout, new Watcher() {
@Override
public void process(WatchedEvent event) {
if (event.getState() == Event.KeeperState.SyncConnected) {
connectedSignal.countDown();
}
System.out.println("触发了"+event.getType()+"事件");
}
});
connectedSignal.await();
} catch (Exception e) {
e.printStackTrace();
}
return zk;
}
}
注释:
大部分注释我都写在了代码的方法上面,另外,童鞋们需要注意:
ZooKeeper中一共由三种方法可以实现Watcher,分别为getData、exists和getChildren.
使用zkCli连接zookeeper查看数据:
可以看到已经成功完成了java连接zookeeper并对zookeeper增删改查等操作。