1 系列目录

• ZooKeeper源码研究系列（1）源码环境搭建
• ZooKeeper源码研究系列（2）客户端创建连接过程分析
• ZooKeeper源码研究系列（3）单机版服务器介绍
• ZooKeeper源码研究系列（4）集群版服务器介绍

2 搭建步骤

2.1 到github中fork该项目

项目地址 https://github.com/apache/zookeeper。fork完成之后就存至自己的仓库中了。

2.2 clone上述自己的仓库地址到本地

先看下大体的代码格式：

2.3 使用ant对源码编译成eclipse工程

首先选定一个分支，我自己选择branch-3.4分支来进行源码研究。即

git checkout branch-3.4

上述源码还不是eclipse工程。需要使用ant eclipse命令来转换成eclipse工程。ant就不用再说了，自行网上搜索与配置。

ant eclipse

这里来重点说说ant eclipse执行失败的问题。

• 1 上述命令会下载ant-eclipse-1.0.bin.tar.bz2文件，老是下载不成功，无法继续下去

  修改源码中build.xml中的配置，将地址

  get src="http://downloads.sourceforge.net/project/ant-eclipse/ant-eclipse/1.0/ant-eclipse-1.0.bin.tar.bz2"

  更换成如下地址

  get src="http://ufpr.dl.sourceforge.net/project/ant-eclipse/ant-eclipse/1.0/ant-eclipse-1.0.bin.tar.bz2"

• 2 还发现缺少依赖包 commons-collections

  在ivy.xml文件中加入如下配置

  <dependency org="commons-collections" name="commons-collections" rev="3.0"/>

上述两个问题解决后，再重新执行ant eclipse命令。

2.4 导入项目到eclipse工程中

将eclipse的编译器版本设置为1.7。然后整个世界就安静了，终于不再报错了。下面就是要看看如何在eclipse中运行

3 运行ZooKeeper

我们首先看下单机版ZooKeeper的启动类org.apache.zookeeper.server.ZooKeeperServerMain。

它的启动参数有两种情况：

情况1：直接给出相应的参数设置。

有4个参数，前两个参数必填，后两个参数可选

对客户端暴漏出的端口port，dataDir的目录，tickTime值，maxClientCnxns值（最大的客户端连接数）。下面分别来简单介绍下：

• 对客户端暴漏出的端口port，即如下客户端代码指定的端口

  new ZooKeeper("192.168.126.130:2181",5000,this)

• dataDir的目录

  ZooKeeper有两类数据要存储。一种就是事务记录，另一种就是ZooKeeper的内存树中的数据,以快照方式存储。 所以可以给这两种数据指定不同的目录。dataDir用来指定内存树快照的存储位置，dataLogDir用来指定事务记录的存储位置。只给出了dataDir的目录，则代表两种数据都存储在该目录下。

• tickTime值，单位ms,默认3000
  • 用途1：用于指定session检查的间隔

    服务器会每隔一段时间检查一次连接它的客户端的session是否过期。该间隔就是tickTime。

  • 用途2：用于给出默认的minSessionTimeout和maxSessionTimeout

    如果没有给出maxSessionTimeout和minSessionTimeout（为-1），则minSessionTimeout和maxSessionTimeout的取值如下：

    minSessionTimeout == -1 ? tickTime 2 : minSessionTimeout; maxSessionTimeout == -1 ? tickTime 20 : maxSessionTimeout;

    分别是tickTime的2倍和20倍。

    客户端代码在创建ZooKeeper对象的时候会给出一个sessionTimeout时间，而上述的minSessionTimeout和maxSessionTimeout就是用来约束客户端的sessionTimeout。源码如下：

    。

• maxClientCnxns值，用于指定服务器端最大的连接数。

参数说完了，我们就来设置一下：

同时，ZooKeeper采用log4j来作为日志输出，所以需要将log4j的配置文件（在conf文件夹中）放置到类路径下。

所以该项目右键，Build Path-》Add Class Folder 添加conf文件夹作为类路径的一部分。

然后就可以Run了。

情况2：给出配置文件地址

当org.apache.zookeeper.server.ZooKeeperServerMain类的启动参数只有一个时，则代表着配置文件的路径。

也可以修改conf文件夹中的zoo_sample.cfg配置文件，修改下dataDir指定的路径。然后把该配置文件的路径作为参数

4 结束语

至此完成了ZooKeeper的源码环境搭建，可以随意修改和debug了。下一篇文章就会介绍下客户端和服务器端的交互过程。