现在市面上有很多种zookeeper的java客户端库,我们这儿用的是apache的zookeeper库(毕竟现在zookeeper是在apache里面维护)。
1.明确几个zookeeper里面的概念
Zookeeper的节点都是存放在内存中的,所以读写速度很快。更新日志被记录到了磁盘中,以便用于恢复数据。在更新内在中节点数之前,会先序列化到磁盘中,然后才会加载到内存中。
ZooKeeper中的每个节点存储的数据要被原子性的操作。也就是说读操作将获取与节点相关的所有数据,写操作也将替换掉节点的所有数据。另外,每一个节点都拥有自己的ACL(访问控制列表),这个列表规定了用户的权限,即限定了特定用户对目标节点可以执行的操作。
2.引用zookeeper库
这儿用的是maven管理方式,pom.xml的配置:
<dependencies>
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.3</version>
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</exclusion>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.2</version>
</dependency>
</dependencies>
3. zookeeper客户端API的一些简介
Zookeeper API共包含五个包,分别为:
(1)org.apache.zookeeper
(2)org.apache.zookeeper.data
(3)org.apache.zookeeper.server
(4)org.apache.zookeeper.server.quorum
(5)org.apache.zookeeper.server.upgrade
其中org.apache.zookeeper,包含Zookeeper类,他是我们编程时最常用的类文件。这个类是Zookeeper客户端的主要类文件。如果要使用Zookeeper服务,应用程序首先必须创建一个Zookeeper实例,这时就需要使用此类。一旦客户端和Zookeeper服务建立起了连接,Zookeeper系统将会给次连接会话分配一个ID值,并且客户端将会周期性的向服务器端发送心跳来维持会话连接。只要连接有效,客户端就可以使用Zookeeper API来做相应处理了。
4. zookeeper的java ApI详解
4.1 连接zookeeper服务器
public ZooKeeper(String connectString, int sessionTimeout, Watcher watcher)
public ZooKeeper(String connectString, int sessionTimeout, Watcher watcher)
参数说明:
connectString:zookeeper server列表, 以逗号隔开. ZooKeeper对象初始化后, 将从server列表中选择一个server, 并尝试与其建立连接. 如果连接建立失败, 则会从列表的剩余项中选择一个server, 并再次尝试建立连接。
sessionTimeout:指定连接的超时时间。
watcher:一个 watcher 实例。
注意, 创建ZooKeeper对象时, 只要对象完成初始化便立刻返回. 建立连接是以异步的形式进行的, 当连接成功建立后, 会回调watcher的process方法. 如果想要同步建立与server的连接, 需要自己进一步封装。一般我们创建完Zookeeper之后,直接等着其连接好了之后,在watcher的process方法里面让主函数结束等待。
4.2 创建znode(zk节点)
public String create(final String path, byte data[], List<ACL> acl,
CreateMode createMode)
public String create(final String path, byte data[], List<ACL> acl,
CreateMode createMode)
参数说明:
path:znode的路径,必须是绝对路径。
data:与znode关联的数据。
acl:指定权限信息, 如果不想指定权限, 可以传入Ids.OPEN_ACL_UNSAFE。
createMode:指定znode类型. CreateMode是一个枚举类, 从中选择一个成员传入即可。
createMode的可选的成员类型
PERSISTENT:创建后只要不删就永久存在
EPHEMERAL:会话结束年结点自动被删除,EPHEMERAL结点不允许有子节点
SEQUENTIAL:节点名末尾会自动追加一个10位数的单调递增的序号,同一个节点的所有子节点序号是单调递增的
PERSISTENT_SEQUENTIAL:结合PERSISTENT和SEQUENTIAL
EPHEMERAL_SEQUENTIAL:结合EPHEMERAL和SEQUENTIAL
4.3 删除znode节点
public void delete(final String path, int version)
public void delete(final String path, int version)
参数说明:
path:znode的路径,必须是绝对路径。
version:指定要删除的数据的版本, 如果version和真实的版本不同, 删除操作将失败. 指定version为-1则忽略版本检查.
4.4 更新znode节点中的数据
public Stat setData(final String path, byte data[], int version)
public Stat setData(final String path, byte data[], int version)
参数说明:
path:znode的路径,必须是绝对路径。
data:要设置的到znode的数据,注意数据是直接清空原来的数据,然后写新的数据,且数据的大小不能超过1MB。
version:指定要更新的数据的版本, 如果version和真实的版本不同, 更新操作将失败. 指定version为-1则忽略版本检查。
4.5 判断znode是否存在
public Stat exists(final String path, Watcher watcher)
public Stat exists(final String path, Watcher watcher)
参数说明:
path:znode的路径,必须是绝对路径。
watcher:一个 watcher 实例。
如果该node存在, 则返回该node的状态信息, 否则返回null.
public Stat exists(String path, boolean watch)
public Stat exists(String path, boolean watch)
4.6获取znode节点的子节点列表
public List<String> getChildren(final String path, Watcher watcher)
public List<String> getChildren(final String path, Watcher watcher)
参数说明:
path:znode的路径,必须是绝对路径。
watcher:一个 watcher 实例。
如果有child存在,就返回child,如果没有的话,就会返回null
public List<String> getChildren(String path, boolean watch)
public List<String> getChildren(String path, boolean watch)
其余和上面都一样,就是boolean的如果为true,表示要用watcher,这时的watcher是初始化zookeeper时候指定的watcher
4.7获取znode节点的数据
public byte[] getData(final String path, Watcher watcher, Stat stat)
public byte[] getData(final String path, Watcher watcher, Stat stat)
参数说明:
path:znode的路径,必须是绝对路径。
watch:用于指定是否监听path node的删除事件, 以及数据更新事件
, 注意, 不监听path node的创建事件
, 因为如果path node不存在, 该方法将抛出KeeperException.NoNodeException异常.
stat:是个传出参数, getData方法会将path node的状态信息设置到该参数中
.
public byte[] getData(String path, boolean watch, Stat stat)
public byte[] getData(String path, boolean watch, Stat stat)
其余和上面都一样,就是boolean的如果为true,表示要用watcher,这时的watcher是初始化zookeeper时候指定的watcher。
总结:这几个是最常用的API,熟悉了之后,基本95%多的工作都可以通过这个解决,其余的后面的API如果用到可以查文档。