zookeeper原理（轉(zhuǎn)）

ZooKeeper是一個(gè)分布式的，開(kāi)放源碼的分布式應(yīng)用程序協(xié)調(diào)服務(wù)，它包含一個(gè)簡(jiǎn)單的原語(yǔ)集，分布式應(yīng)用程序可以基于它實(shí)現(xiàn)同步服務(wù)，配置維護(hù)和命名服務(wù)等。Zookeeper是hadoop的一個(gè)子項(xiàng)目，其發(fā)展歷程無(wú)需贅述。在分布式應(yīng)用中，由于工程師不能很好地使用鎖機(jī)制，以及基于消息的協(xié)調(diào)機(jī)制不適合在某些應(yīng)用中使用，因此需要有一種可靠的、可擴(kuò)展的、分布式的、可配置的協(xié)調(diào)機(jī)制來(lái)統(tǒng)一系統(tǒng)的狀態(tài)。Zookeeper的目的就在于此。本文簡(jiǎn)單分析zookeeper的工作原理，對(duì)于如何使用zookeeper不是本文討論的重點(diǎn)。

1 Zookeeper的基本概念 1.1 角色

Zookeeper中的角色主要有以下三類，如下表所示：

系統(tǒng)模型如圖所示：

1.2 設(shè)計(jì)目的

1.最終一致性：client不論連接到哪個(gè)Server，展示給它都是同一個(gè)視圖，這是zookeeper最重要的性能。

2 .可靠性：具有簡(jiǎn)單、健壯、良好的性能，如果消息m被到一臺(tái)服務(wù)器接受，那么它將被所有的服務(wù)器接受。

3 .實(shí)時(shí)性：Zookeeper保證客戶端將在一個(gè)時(shí)間間隔范圍內(nèi)獲得服務(wù)器的更新信息，或者服務(wù)器失效的信息。但由于網(wǎng)絡(luò)延時(shí)等原因，Zookeeper不能保證兩個(gè)客戶端能同時(shí)得到剛更新的數(shù)據(jù)，如果需要最新數(shù)據(jù)，應(yīng)該在讀數(shù)據(jù)之前調(diào)用sync()接口。

4 .等待無(wú)關(guān)（wait-free）：慢的或者失效的client不得干預(yù)快速的client的請(qǐng)求，使得每個(gè)client都能有效的等待。

5.原子性：更新只能成功或者失敗，沒(méi)有中間狀態(tài)。

6 .順序性：包括全局有序和偏序兩種：全局有序是指如果在一臺(tái)服務(wù)器上消息a在消息b前發(fā)布，則在所有Server上消息a都將在消息b前被發(fā)布；偏序是指如果一個(gè)消息b在消息a后被同一個(gè)發(fā)送者發(fā)布，a必將排在b前面。

2 ZooKeeper的工作原理

Zookeeper的核心是原子廣播，這個(gè)機(jī)制保證了各個(gè)Server之間的同步。實(shí)現(xiàn)這個(gè)機(jī)制的協(xié)議叫做Zab協(xié)議。Zab協(xié)議有兩種模式，它們分別是恢復(fù)模式（選主）和廣播模式（同步）。當(dāng)服務(wù)啟動(dòng)或者在領(lǐng)導(dǎo)者崩潰后，Zab就進(jìn)入了恢復(fù)模式，當(dāng)領(lǐng)導(dǎo)者被選舉出來(lái)，且大多數(shù)Server完成了和leader的狀態(tài)同步以后，恢復(fù)模式就結(jié)束了。狀態(tài)同步保證了leader和Server具有相同的系統(tǒng)狀態(tài)。

為了保證事務(wù)的順序一致性，zookeeper采用了遞增的事務(wù)id號(hào)（zxid）來(lái)標(biāo)識(shí)事務(wù)。所有的提議（proposal）都在被提出的時(shí)候加上了zxid。實(shí)現(xiàn)中zxid是一個(gè)64位的數(shù)字，它高32位是epoch用來(lái)標(biāo)識(shí)leader關(guān)系是否改變，每次一個(gè)leader被選出來(lái)，它都會(huì)有一個(gè)新的epoch，標(biāo)識(shí)當(dāng)前屬于那個(gè)leader的統(tǒng)治時(shí)期。低32位用于遞增計(jì)數(shù)。

每個(gè)Server在工作過(guò)程中有三種狀態(tài)：

LOOKING：當(dāng)前Server不知道leader是誰(shuí)，正在搜尋

LEADING：當(dāng)前Server即為選舉出來(lái)的leader

FOLLOWING：leader已經(jīng)選舉出來(lái)，當(dāng)前Server與之同步

2.1 選主流程

當(dāng)leader崩潰或者leader失去大多數(shù)的follower，這時(shí)候zk進(jìn)入恢復(fù)模式，恢復(fù)模式需要重新選舉出一個(gè)新的leader，讓所有的Server都恢復(fù)到一個(gè)正確的狀態(tài)。Zk的選舉算法有兩種：一種是基于basic paxos實(shí)現(xiàn)的，另外一種是基于fast paxos算法實(shí)現(xiàn)的。系統(tǒng)默認(rèn)的選舉算法為fast paxos。先介紹basic paxos流程：

1 .選舉線程由當(dāng)前Server發(fā)起選舉的線程擔(dān)任，其主要功能是對(duì)投票結(jié)果進(jìn)行統(tǒng)計(jì)，并選出推薦的Server；

2 .選舉線程首先向所有Server發(fā)起一次詢問(wèn)(包括自己)；

3 .選舉線程收到回復(fù)后，驗(yàn)證是否是自己發(fā)起的詢問(wèn)(驗(yàn)證zxid是否一致)，然后獲取對(duì)方的id(myid)，并存儲(chǔ)到當(dāng)前詢問(wèn)對(duì)象列表中，最后獲取對(duì)方提議的leader相關(guān)信息(id,zxid)，并將這些信息存儲(chǔ)到當(dāng)次選舉的投票記錄表中；

4. ?收到所有Server回復(fù)以后，就計(jì)算出zxid最大的那個(gè)Server，并將這個(gè)Server相關(guān)信息設(shè)置成下一次要投票的Server；

5. ?線程將當(dāng)前zxid最大的Server設(shè)置為當(dāng)前Server要推薦的Leader，如果此時(shí)獲勝的Server獲得n/2 + 1的Server票數(shù)， 設(shè)置當(dāng)前推薦的leader為獲勝的Server，將根據(jù)獲勝的Server相關(guān)信息設(shè)置自己的狀態(tài)，否則，繼續(xù)這個(gè)過(guò)程，直到leader被選舉出來(lái)。

通過(guò)流程分析我們可以得出：要使Leader獲得多數(shù)Server的支持，則Server總數(shù)必須是奇數(shù)2n+1，且存活的Server的數(shù)目不得少于n+1.

每個(gè)Server啟動(dòng)后都會(huì)重復(fù)以上流程。在恢復(fù)模式下，如果是剛從崩潰狀態(tài)恢復(fù)的或者剛啟動(dòng)的server還會(huì)從磁盤快照中恢復(fù)數(shù)據(jù)和會(huì)話信息，zk會(huì)記錄事務(wù)日志并定期進(jìn)行快照，方便在恢復(fù)時(shí)進(jìn)行狀態(tài)恢復(fù)。選主的具體流程圖如下所示：

fast paxos流程是在選舉過(guò)程中，某Server首先向所有Server提議自己要成為leader，當(dāng)其它Server收到提議以后，解決epoch和zxid的沖突，并接受對(duì)方的提議，然后向?qū)Ψ桨l(fā)送接受提議完成的消息，重復(fù)這個(gè)流程，最后一定能選舉出Leader。其流程圖如下所示：

2.2 同步流程

選完leader以后，zk就進(jìn)入狀態(tài)同步過(guò)程。

1. leader等待server連接；

2 .Follower連接leader，將最大的zxid發(fā)送給leader；

3 .Leader根據(jù)follower的zxid確定同步點(diǎn)；

4 .完成同步后通知follower 已經(jīng)成為uptodate狀態(tài)；

5 .Follower收到uptodate消息后，又可以重新接受client的請(qǐng)求進(jìn)行服務(wù)了。

流程圖如下所示：

2.3 工作流程 2.3.1 Leader工作流程

Leader主要有三個(gè)功能：

1 .恢復(fù)數(shù)據(jù)；

2 .維持與Learner的心跳，接收Learner請(qǐng)求并判斷Learner的請(qǐng)求消息類型；

3 .Learner的消息類型主要有PING消息、REQUEST消息、ACK消息、REVALIDATE消息，根據(jù)不同的消息類型，進(jìn)行不同的處理。

PING消息是指Learner的心跳信息；REQUEST消息是Follower發(fā)送的提議信息，包括寫請(qǐng)求及同步請(qǐng)求；ACK消息是Follower的對(duì)提議的回復(fù)，超過(guò)半數(shù)的Follower通過(guò)，則commit該提議；REVALIDATE消息是用來(lái)延長(zhǎng)SESSION有效時(shí)間。
Leader的工作流程簡(jiǎn)圖如下所示，在實(shí)際實(shí)現(xiàn)中，流程要比下圖復(fù)雜得多，啟動(dòng)了三個(gè)線程來(lái)實(shí)現(xiàn)功能。

2.3.2 Follower工作流程

Follower主要有四個(gè)功能：

1. 向Leader發(fā)送請(qǐng)求（PING消息、REQUEST消息、ACK消息、REVALIDATE消息）；

2 .接收Leader消息并進(jìn)行處理；

3 .接收Client的請(qǐng)求，如果為寫請(qǐng)求，發(fā)送給Leader進(jìn)行投票；

4 .返回Client結(jié)果。

Follower的消息循環(huán)處理如下幾種來(lái)自Leader的消息：

1 .PING消息： 心跳消息；

2 .PROPOSAL消息：Leader發(fā)起的提案，要求Follower投票；

3 .COMMIT消息：服務(wù)器端最新一次提案的信息；

4 .UPTODATE消息：表明同步完成；

5 .REVALIDATE消息：根據(jù)Leader的REVALIDATE結(jié)果，關(guān)閉待revalidate的session還是允許其接受消息；

6 .SYNC消息：返回SYNC結(jié)果到客戶端，這個(gè)消息最初由客戶端發(fā)起，用來(lái)強(qiáng)制得到最新的更新。

Follower的工作流程簡(jiǎn)圖如下所示，在實(shí)際實(shí)現(xiàn)中，F(xiàn)ollower是通過(guò)5個(gè)線程來(lái)實(shí)現(xiàn)功能的。

對(duì)于observer的流程不再敘述，observer流程和Follower的唯一不同的地方就是observer不會(huì)參加leader發(fā)起的投票。

主流應(yīng)用場(chǎng)景：

Zookeeper的主流應(yīng)用場(chǎng)景實(shí)現(xiàn)思路（除去官方示例）?

(1)配置管理
集中式的配置管理在應(yīng)用集群中是非常常見(jiàn)的，一般商業(yè)公司內(nèi)部都會(huì)實(shí)現(xiàn)一套集中的配置管理中心，應(yīng)對(duì)不同的應(yīng)用集群對(duì)于共享各自配置的需求，并且在配置變更時(shí)能夠通知到集群中的每一個(gè)機(jī)器。

Zookeeper很容易實(shí)現(xiàn)這種集中式的配置管理，比如將APP1的所有配置配置到/APP1 znode下，APP1所有機(jī)器一啟動(dòng)就對(duì)/APP1這個(gè)節(jié)點(diǎn)進(jìn)行監(jiān)控(zk.exist("/APP1",true)),并且實(shí)現(xiàn)回調(diào)方法Watcher，那么在zookeeper上/APP1 znode節(jié)點(diǎn)下數(shù)據(jù)發(fā)生變化的時(shí)候，每個(gè)機(jī)器都會(huì)收到通知，Watcher方法將會(huì)被執(zhí)行，那么應(yīng)用再取下數(shù)據(jù)即可(zk.getData("/APP1",false,null));

以上這個(gè)例子只是簡(jiǎn)單的粗顆粒度配置監(jiān)控，細(xì)顆粒度的數(shù)據(jù)可以進(jìn)行分層級(jí)監(jiān)控，這一切都是可以設(shè)計(jì)和控制的。?????
(2)集群管理?
應(yīng)用集群中，我們常常需要讓每一個(gè)機(jī)器知道集群中（或依賴的其他某一個(gè)集群）哪些機(jī)器是活著的，并且在集群機(jī)器因?yàn)殄礄C(jī)，網(wǎng)絡(luò)斷鏈等原因能夠不在人工介入的情況下迅速通知到每一個(gè)機(jī)器。

Zookeeper同樣很容易實(shí)現(xiàn)這個(gè)功能，比如我在zookeeper服務(wù)器端有一個(gè)znode叫/APP1SERVERS,那么集群中每一個(gè)機(jī)器啟動(dòng)的時(shí)候都去這個(gè)節(jié)點(diǎn)下創(chuàng)建一個(gè)EPHEMERAL類型的節(jié)點(diǎn)，比如server1創(chuàng)建/APP1SERVERS/SERVER1(可以使用ip,保證不重復(fù))，server2創(chuàng)建/APP1SERVERS/SERVER2，然后SERVER1和SERVER2都watch /APP1SERVERS這個(gè)父節(jié)點(diǎn)，那么也就是這個(gè)父節(jié)點(diǎn)下數(shù)據(jù)或者子節(jié)點(diǎn)變化都會(huì)通知對(duì)該節(jié)點(diǎn)進(jìn)行watch的客戶端。因?yàn)镋PHEMERAL類型節(jié)點(diǎn)有一個(gè)很重要的特性，就是客戶端和服務(wù)器端連接斷掉或者session過(guò)期就會(huì)使節(jié)點(diǎn)消失，那么在某一個(gè)機(jī)器掛掉或者斷鏈的時(shí)候，其對(duì)應(yīng)的節(jié)點(diǎn)就會(huì)消失，然后集群中所有對(duì)/APP1SERVERS進(jìn)行watch的客戶端都會(huì)收到通知，然后取得最新列表即可。

另外有一個(gè)應(yīng)用場(chǎng)景就是集群選master,一旦master掛掉能夠馬上能從slave中選出一個(gè)master,實(shí)現(xiàn)步驟和前者一樣，只是機(jī)器在啟動(dòng)的時(shí)候在APP1SERVERS創(chuàng)建的節(jié)點(diǎn)類型變?yōu)镋PHEMERAL_SEQUENTIAL類型，這樣每個(gè)節(jié)點(diǎn)會(huì)自動(dòng)被編號(hào)

我們默認(rèn)規(guī)定編號(hào)最小的為master,所以當(dāng)我們對(duì)/APP1SERVERS節(jié)點(diǎn)做監(jiān)控的時(shí)候，得到服務(wù)器列表，只要所有集群機(jī)器邏輯認(rèn)為最小編號(hào)節(jié)點(diǎn)為master，那么master就被選出，而這個(gè)master宕機(jī)的時(shí)候，相應(yīng)的znode會(huì)消失，然后新的服務(wù)器列表就被推送到客戶端，然后每個(gè)節(jié)點(diǎn)邏輯認(rèn)為最小編號(hào)節(jié)點(diǎn)為master，這樣就做到動(dòng)態(tài)master選舉。

Zookeeper 監(jiān)視（Watches） 簡(jiǎn)介

Zookeeper C API 的聲明和描述在 include/zookeeper.h 中可以找到，另外大部分的 Zookeeper C API 常量、結(jié)構(gòu)體聲明也在 zookeeper.h 中，如果如果你在使用 C API 是遇到不明白的地方，最好看看 zookeeper.h，或者自己使用 doxygen 生成 Zookeeper C API 的幫助文檔。

Zookeeper 中最有特色且最不容易理解的是監(jiān)視(Watches)。Zookeeper 所有的讀操作——getData(),?getChildren(), 和?exists()?都 可以設(shè)置監(jiān)視(watch)，監(jiān)視事件可以理解為一次性的觸發(fā)器， 官方定義如下： a watch event is one-time trigger, sent to the client that set the watch, which occurs when the data for which the watch was set changes。對(duì)此需要作出如下理解：

（一次性觸發(fā)）One-time trigger

當(dāng)設(shè)置監(jiān)視的數(shù)據(jù)發(fā)生改變時(shí)，該監(jiān)視事件會(huì)被發(fā)送到客戶端，例如，如果客戶端調(diào)用了 getData("/znode1", true) 并且稍后 /znode1 節(jié)點(diǎn)上的數(shù)據(jù)發(fā)生了改變或者被刪除了，客戶端將會(huì)獲取到 /znode1 發(fā)生變化的監(jiān)視事件，而如果 /znode1 再一次發(fā)生了變化，除非客戶端再次對(duì) /znode1 設(shè)置監(jiān)視，否則客戶端不會(huì)收到事件通知。

（發(fā)送至客戶端）Sent to the client

Zookeeper 客戶端和服務(wù)端是通過(guò) socket 進(jìn)行通信的，由于網(wǎng)絡(luò)存在故障，所以監(jiān)視事件很有可能不會(huì)成功地到達(dá)客戶端，監(jiān)視事件是異步發(fā)送至監(jiān)視者的，Zookeeper 本身提供了保序性(ordering guarantee)：即客戶端只有首先看到了監(jiān)視事件后，才會(huì)感知到它所設(shè)置監(jiān)視的 znode 發(fā)生了變化(a client will never see a change for which it has set a watch until it first sees the watch event). 網(wǎng)絡(luò)延遲或者其他因素可能導(dǎo)致不同的客戶端在不同的時(shí)刻感知某一監(jiān)視事件，但是不同的客戶端所看到的一切具有一致的順序。

（被設(shè)置 watch 的數(shù)據(jù)）The data for which the watch was set

這意味著 znode 節(jié)點(diǎn)本身具有不同的改變方式。你也可以想象 Zookeeper 維護(hù)了兩條監(jiān)視鏈表：數(shù)據(jù)監(jiān)視和子節(jié)點(diǎn)監(jiān)視(data watches and child watches) getData() and exists() 設(shè)置數(shù)據(jù)監(jiān)視，getChildren() 設(shè)置子節(jié)點(diǎn)監(jiān)視。 或者，你也可以想象 Zookeeper 設(shè)置的不同監(jiān)視返回不同的數(shù)據(jù)，getData() 和 exists() 返回 znode 節(jié)點(diǎn)的相關(guān)信息，而 getChildren() 返回子節(jié)點(diǎn)列表。因此， setData() 會(huì)觸發(fā)設(shè)置在某一節(jié)點(diǎn)上所設(shè)置的數(shù)據(jù)監(jiān)視(假定數(shù)據(jù)設(shè)置成功)，而一次成功的 create() 操作則會(huì)出發(fā)當(dāng)前節(jié)點(diǎn)上所設(shè)置的數(shù)據(jù)監(jiān)視以及父節(jié)點(diǎn)的子節(jié)點(diǎn)監(jiān)視。一次成功的 delete() 操作將會(huì)觸發(fā)當(dāng)前節(jié)點(diǎn)的數(shù)據(jù)監(jiān)視和子節(jié)點(diǎn)監(jiān)視事件，同時(shí)也會(huì)觸發(fā)該節(jié)點(diǎn)父節(jié)點(diǎn)的child watch。

Zookeeper 中的監(jiān)視是輕量級(jí)的，因此容易設(shè)置、維護(hù)和分發(fā)。當(dāng)客戶端與 Zookeeper 服務(wù)器端失去聯(lián)系時(shí)，客戶端并不會(huì)收到監(jiān)視事件的通知，只有當(dāng)客戶端重新連接后，若在必要的情況下，以前注冊(cè)的監(jiān)視會(huì)重新被注冊(cè)并觸發(fā)，對(duì)于開(kāi)發(fā)人員來(lái)說(shuō) 這通常是透明的。只有一種情況會(huì)導(dǎo)致監(jiān)視事件的丟失，即：通過(guò) exists() 設(shè)置了某個(gè) znode 節(jié)點(diǎn)的監(jiān)視，但是如果某個(gè)客戶端在此 znode 節(jié)點(diǎn)被創(chuàng)建和刪除的時(shí)間間隔內(nèi)與 zookeeper 服務(wù)器失去了聯(lián)系，該客戶端即使稍后重新連接 zookeeper服務(wù)器后也得不到事件通知。

Zookeeper C API 常量與部分結(jié)構(gòu)(struct)介紹 與 ACL 相關(guān)的結(jié)構(gòu)與常量：

struct Id 結(jié)構(gòu)為：

struct?Id?{?????char?*?scheme;?????char?*?id;?};

?

struct ACL 結(jié)構(gòu)為：

struct?ACL?{?????int32_t?perms;?????struct?Id?id;?};

?

struct ACL_vector 結(jié)構(gòu)為：

struct?ACL_vector?{?????int32_t?count;?????struct?ACL?*data;?};

?

與 znode 訪問(wèn)權(quán)限有關(guān)的常量

const?int?ZOO_PERM_READ; //允許客戶端讀取 znode 節(jié)點(diǎn)的值以及子節(jié)點(diǎn)列表。

const?int?ZOO_PERM_WRITE;// 允許客戶端設(shè)置 znode 節(jié)點(diǎn)的值。

const?int?ZOO_PERM_CREATE; //允許客戶端在該 znode 節(jié)點(diǎn)下創(chuàng)建子節(jié)點(diǎn)。

const?int?ZOO_PERM_DELETE;//允許客戶端刪除子節(jié)點(diǎn)。

const?int?ZOO_PERM_ADMIN; //允許客戶端執(zhí)行 set_acl()。

const?int?ZOO_PERM_ALL;//允許客戶端執(zhí)行所有操作，等價(jià)與上述所有標(biāo)志的或(OR) 。

與 ACL IDs 相關(guān)的常量

struct?Id ZOO_ANYONE_ID_UNSAFE; //(‘world’,’anyone’)

struct?Id ZOO_AUTH_IDS;// (‘a(chǎn)uth’,’’)

三種標(biāo)準(zhǔn)的 ACL

struct?ACL_vector ZOO_OPEN_ACL_UNSAFE; //(ZOO_PERM_ALL,ZOO_ANYONE_ID_UNSAFE)

struct?ACL_vector ZOO_READ_ACL_UNSAFE;// (ZOO_PERM_READ, ZOO_ANYONE_ID_UNSAFE)

struct?ACL_vector ZOO_CREATOR_ALL_ACL; //(ZOO_PERM_ALL,ZOO_AUTH_IDS)

與 Interest 相關(guān)的常量：ZOOKEEPER_WRITE,?ZOOKEEPER_READ

這 兩個(gè)常量用于標(biāo)識(shí)感興趣的事件并通知 zookeeper 發(fā)生了哪些事件。Interest 常量可以進(jìn)行組合或（OR）來(lái)標(biāo)識(shí)多種興趣(multiple interests: write, read)，這兩個(gè)常量一般用于 zookeeper_interest() 和 zookeeper_process()兩個(gè)函數(shù)中。

與節(jié)點(diǎn)創(chuàng)建相關(guān)的常量：ZOO_EPHEMERAL,?ZOO_SEQUENCE

zoo_create 函數(shù)標(biāo)志，ZOO_EPHEMERAL?用來(lái)標(biāo)識(shí)創(chuàng)建臨時(shí)節(jié)點(diǎn)，ZOO_SEQUENCE?用來(lái)標(biāo)識(shí)節(jié)點(diǎn)命名具有遞增的后綴序號(hào)(一般是節(jié)點(diǎn)名稱后填充 10 位字符的序號(hào)，如 /xyz0000000000, /xyz0000000001, /xyz0000000002, ...)，同樣地，ZOO_EPHEMERAL,?ZOO_SEQUENCE?可以組合。

與連接狀態(tài) Stat 相關(guān)的常量

以下常量均與 Zookeeper 連接狀態(tài)有關(guān)，他們通常用作監(jiān)視器回調(diào)函數(shù)的參數(shù)。

ZOOAPI const int? ZOO_EXPIRED_SESSION_STATE ZOOAPI const int? ZOO_AUTH_FAILED_STATE ZOOAPI const int? ZOO_CONNECTING_STATE ZOOAPI const int? ZOO_ASSOCIATING_STATE ZOOAPI const int? ZOO_CONNECTED_STATE 與監(jiān)視類型(Watch Types)相關(guān)的常量

以下常量標(biāo)識(shí)監(jiān)視事件的類型，他們通常用作監(jiān)視器回調(diào)函數(shù)的第一個(gè)參數(shù)。

ZOO_CREATED_EVENT; // 節(jié)點(diǎn)被創(chuàng)建(此前該節(jié)點(diǎn)不存在)，通過(guò) zoo_exists() 設(shè)置監(jiān)視。

ZOO_DELETED_EVENT; // 節(jié)點(diǎn)被刪除，通過(guò) zoo_exists() 和 zoo_get() 設(shè)置監(jiān)視。

ZOO_CHANGED_EVENT; // 節(jié)點(diǎn)發(fā)生變化，通過(guò) zoo_exists() 和 zoo_get() 設(shè)置監(jiān)視。

ZOO_CHILD_EVENT; // 子節(jié)點(diǎn)事件，通過(guò)zoo_get_children() 和 zoo_get_children2()設(shè)置監(jiān)視。

ZOO_SESSION_EVENT; // 會(huì)話丟失

ZOO_NOTWATCHING_EVENT; // 監(jiān)視被移除。

Zookeeper C API 錯(cuò)誤碼介紹?ZOO_ERRORS ZOK?

正常返回

ZSYSTEMERROR?

系統(tǒng)或服務(wù)器端錯(cuò)誤(System and server-side errors)，服務(wù)器不會(huì)拋出該錯(cuò)誤，該錯(cuò)誤也只是用來(lái)標(biāo)識(shí)錯(cuò)誤范圍的，即大于該錯(cuò)誤值，且小于 ZAPIERROR 都是系統(tǒng)錯(cuò)誤。

ZRUNTIMEINCONSISTENCY?

運(yùn)行時(shí)非一致性錯(cuò)誤。

ZDATAINCONSISTENCY?

數(shù)據(jù)非一致性錯(cuò)誤。

ZCONNECTIONLOSS?

Zookeeper 客戶端與服務(wù)器端失去連接

ZMARSHALLINGERROR?

在?marshalling?和?unmarshalling?數(shù)據(jù)時(shí)出現(xiàn)錯(cuò)誤(Error while marshalling or unmarshalling data)

ZUNIMPLEMENTED?

該操作未實(shí)現(xiàn)(Operation is unimplemented)

ZOPERATIONTIMEOUT?

該操作超時(shí)(Operation timeout)

ZBADARGUMENTS?

非法參數(shù)錯(cuò)誤(Invalid arguments)

ZINVALIDSTATE?

非法句柄狀態(tài)(Invliad zhandle state)

ZAPIERROR?

API 錯(cuò)誤(API errors)，服務(wù)器不會(huì)拋出該錯(cuò)誤，該錯(cuò)誤也只是用來(lái)標(biāo)識(shí)錯(cuò)誤范圍的，錯(cuò)誤值大于該值的標(biāo)識(shí) API 錯(cuò)誤，而小于該值的標(biāo)識(shí) ZSYSTEMERROR。

ZNONODE?

節(jié)點(diǎn)不存在(Node does not exist)

ZNOAUTH?

沒(méi)有經(jīng)過(guò)授權(quán)(Not authenticated)

ZBADVERSION?

版本沖突(Version conflict)

ZNOCHILDRENFOREPHEMERALS?

臨時(shí)節(jié)點(diǎn)不能擁有子節(jié)點(diǎn)(Ephemeral nodes may not have children)

ZNODEEXISTS?

節(jié)點(diǎn)已經(jīng)存在(The node already exists)

ZNOTEMPTY?

該節(jié)點(diǎn)具有自身的子節(jié)點(diǎn)(The node has children)

ZSESSIONEXPIRED?

會(huì)話過(guò)期(The session has been expired by the server)

ZINVALIDCALLBACK?

非法的回調(diào)函數(shù)(Invalid callback specified)

ZINVALIDACL?

非法的ACL(Invalid ACL specified)

ZAUTHFAILED?

客戶端授權(quán)失敗(Client authentication failed)

ZCLOSING?

Zookeeper 連接關(guān)閉(ZooKeeper is closing)

ZNOTHING?

并非錯(cuò)誤，客戶端不需要處理服務(wù)器的響應(yīng)(not error, no server responses to process)

ZSESSIONMOVED?

會(huì)話轉(zhuǎn)移至其他服務(wù)器，所以操作被忽略(session moved to another server, so operation is ignored)

?

Watch事件類型：

?

ZOO_CREATED_EVENT：節(jié)點(diǎn)創(chuàng)建事件，需要watch一個(gè)不存在的節(jié)點(diǎn)，當(dāng)節(jié)點(diǎn)被創(chuàng)建時(shí)觸發(fā)，此watch通過(guò)zoo_exists()設(shè)置
ZOO_DELETED_EVENT：節(jié)點(diǎn)刪除事件，此watch通過(guò)zoo_exists()或zoo_get()設(shè)置
ZOO_CHANGED_EVENT：節(jié)點(diǎn)數(shù)據(jù)改變事件，此watch通過(guò)zoo_exists()或zoo_get()設(shè)置
ZOO_CHILD_EVENT：子節(jié)點(diǎn)列表改變事件，此watch通過(guò)zoo_get_children()或zoo_get_children2()設(shè)置
ZOO_SESSION_EVENT：會(huì)話失效事件，客戶端與服務(wù)端斷開(kāi)或重連時(shí)觸發(fā)
ZOO_NOTWATCHING_EVENT：watch移除事件，服務(wù)端出于某些原因不再為客戶端watch節(jié)點(diǎn)時(shí)觸發(fā)