在我们了解request和response对象之前我们要先了解一下org.apache.zookeeper.ClientCnxn、org.apache.zookeeper.proto.ReplyHeader。
ClientCnxn做了什么
从源码的说明上我们可以了解到ClientCnxn用于管理客户端的 socket i/o,并维护可用服务器的列表,提供连接服务。我们所有与Zookeeper Server交互的操作都是由ClientCnxn完成的。
//org.apache.zookeeper.ZooKeeper
public ZooKeeper(String connectString, int sessionTimeout, Watcher watcher,
long sessionId, byte[] sessionPasswd)
throws IOException
{
LOG.info("Initiating client connection, connectString=" + connectString
+ " sessionTimeout=" + sessionTimeout
+ " watcher=" + watcher
+ " sessionId=" + sessionId
+ " sessionPasswd="
+ (sessionPasswd == null ? "<null>" : "<hidden>"));
watchManager.defaultWatcher = watcher;
cnxn = new ClientCnxn(connectString, sessionTimeout, this, watchManager, sessionId, sessionPasswd);
cnxn.start();
}
ReplyHeader是什么
从名称上我们可以读懂这个类包含了请求的返回信息。成员变量err可以通过get方法得到,用于记录错误码,0表示操作成功。
if (r.getErr() != 0) {
if (r.getErr() == KeeperException.Code.NONODE.intValue()) {
return null;
}
throw KeeperException.create(KeeperException.Code.get(r.getErr()),
clientPath);
}
ZooKeeper.getData中的request、response
org.apache.zookeeper.proto.GetDataRequest类中包含两个成员变量 String path 和 boolean watch。path是请求的节点路径,watch表示对节点是否进行观察。可以通过 GetDataRequest(String path, boolean watch) 构造方法和 get/set 方法进行操作。
GetDataRequest request = new GetDataRequest();
request.setPath(serverPath);
request.setWatch(watcher != null);
org.apache.zookeeper.proto.GetDataResponse类中包含两个成员变量byte[] data和Stat stat。data用于存储请求完成后返回的节点数据,stat用于存储请求完成后返回的节点状态信息。当请求完成后我们可以调用get方法来取得数据。
GetDataResponse response = new GetDataResponse();
...
if (stat != null) {
DataTree.copyStat(response.getStat(), stat);
}
return response.getData();
当我们具有了request和response后就可以通过ClientCnxn的submitRequest方法得到节点数据了。
public byte[] getData(final String path, Watcher watcher, Stat stat)
throws KeeperException, InterruptedException
{
final String clientPath = path;
PathUtils.validatePath(clientPath);
// the watch contains the un-chroot path
WatchRegistration wcb = null;
if (watcher != null) {
wcb = new DataWatchRegistration(watcher, clientPath); //封装观察对象
}
final String serverPath = prependChroot(clientPath); //得到节点的服务器全路径
RequestHeader h = new RequestHeader(); //定义请求头对象
h.setType(ZooDefs.OpCode.getData); //设置本次请求类型为得到值的操作
GetDataRequest request = new GetDataRequest(); //实例化request对象和属性定义
request.setPath(serverPath);
request.setWatch(watcher != null);
GetDataResponse response = new GetDataResponse(); //实例化respinse对象
ReplyHeader r = cnxn.submitRequest(h, request, response, wcb); //进行请求并得到回复信息
if (r.getErr() != 0) {
throw KeeperException.create(KeeperException.Code.get(r.getErr()),
clientPath);
}
if (stat != null) {
DataTree.copyStat(response.getStat(), stat); //将成功后返回的节点状态信息转写到用户指定的Stat对象中
}
return response.getData(); //返回节点数据
}