ZooKeeper源码研究系列(1)源码环境搭建

原创
2015/07/29 07:03
阅读数 1.5W

#1 系列目录

#2 搭建步骤

##2.1 到github中fork该项目

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

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

先看下大体的代码格式:

ZooKeeper的源码目录

##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参数

同时,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了。下一篇文章就会介绍下客户端和服务器端的交互过程。

展开阅读全文
加载中

作者的其它热门文章

打赏
4
53 收藏
分享
打赏
4 评论
53 收藏
4
分享
返回顶部
顶部