zookeeper Watcher API 說明

　　Watcher 在 ZooKeeper 是一個核心功能,Watcher 能夠監控目錄節點的數據變化以及子目錄的變化,一旦這些狀態發生變化,服務器就會通知全部設置在這個目錄節點上的 Watcher,從而每一個客戶端都很快知道它所關注的目錄節點的狀態發生變化,而作出相應的反應.

能夠設置觀察的操做：exists,getChildren,getData

能夠觸發觀察的操做：create,delete,setData

znode以某種方式發生變化時,「觀察」(watch)機制可讓客戶端獲得通知.能夠針對ZooKeeper服務的「操做」來設置觀察,該服務的其餘 操做能夠觸發觀察.

好比,客戶端能夠對某個客戶端調用exists操做,同時在它上面設置一個觀察,若是此時這個znode不存在,則exists返回 false,若是一段時間以後,這個znode被其餘客戶端建立,則這個觀察會被觸發,以前的那個客戶端就會獲得通知.

說明: zookeeper客戶端對server的操做都是不可回退的。
意思是說，zk的客戶端每次和server進行通訊的時候，會記住server上最新的zxid。若是某個時刻，客戶端和server斷開了鏈接，那麼等到下次從新鏈接到集羣中的機器上時，會檢查當前鏈接上的那個server是否和client有相同的zxid，或者已是更新的zxid了。一旦客戶端發現server的zxid比本身小，那麼客戶端會斷開和這個server的鏈接，而且從新鏈接集羣中的其它server.

一、連接Zookeeper服務器

/** * <p>鏈接Zookeeper</p> * <pre> * [關於connectString服務器地址配置] * 格式: 192.168.1.1:2181,192.168.1.2:2181,192.168.1.3:2181 * 這個地址配置有多個ip:port之間逗號分隔,底層操做 * ConnectStringParser connectStringParser = new ConnectStringParser(「192.168.1.1:2181,192.168.1.2:2181,192.168.1.3:2181」); * 這個類主要就是解析傳入地址列表字符串，將其它保存在一個ArrayList中 * ArrayList<InetSocketAddress> serverAddresses = new ArrayList<InetSocketAddress>(); * 接下去，這個地址列表會被進一步封裝成StaticHostProvider對象，而且在運行過程當中，一直是這個對象來維護整個地址列表。 * ZK客戶端將全部Server保存在一個List中，而後隨機打亂(這個隨機過程是一次性的)，而且造成一個環，具體使用的時候，從0號位開始一個一個使用。 * 所以，Server地址可以重複配置，這樣可以彌補客戶端沒法設置Server權重的缺陷，可是也會加大風險。 * * [客戶端和服務端會話說明] * ZooKeeper中，客戶端和服務端創建鏈接後，會話隨之創建，生成一個全局惟一的會話ID(Session ID)。 * 服務器和客戶端之間維持的是一個長鏈接，在SESSION_TIMEOUT時間內，服務器會肯定客戶端是否正常鏈接(客戶端會定時向服務器發送heart_beat，服務器重置下次SESSION_TIMEOUT時間)。 * 所以，在正常狀況下，Session一直有效，而且ZK集羣全部機器上都保存這個Session信息。 * 在出現網絡或其它問題狀況下（例如客戶端所鏈接的那臺ZK機器掛了，或是其它緣由的網絡閃斷）,客戶端與當前鏈接的那臺服務器之間鏈接斷了, * 這個時候客戶端會主動在地址列表（實例化ZK對象的時候傳入構造方法的那個參數connectString）中選擇新的地址進行鏈接。 * * [會話時間] * 客戶端並非能夠隨意設置這個會話超時時間，在ZK服務器端對會話超時時間是有限制的，主要是minSessionTimeout和maxSessionTimeout這兩個參數設置的。 * 若是客戶端設置的超時時間不在這個範圍，那麼會被強制設置爲最大或最小時間。 默認的Session超時時間是在2 * tickTime ~ 20 * tickTime * </pre> * @param connectString Zookeeper服務地址 * @param sessionTimeout Zookeeper鏈接超時時間 */
    public void connectionZookeeper(String connectString, int sessionTimeout){ this.releaseConnection(); try { // ZK客戶端容許咱們將ZK服務器的全部地址都配置在這裏
            zk = new ZooKeeper(connectString, sessionTimeout, this ); // 使用CountDownLatch.await()的線程（當前線程）阻塞直到全部其它擁有CountDownLatch的線程執行完畢（countDown()結果爲0）
 connectedSemaphore.await(); } catch ( InterruptedException e ) { LOG.error("鏈接建立失敗，發生 InterruptedException , e " + e.getMessage(), e); } catch ( IOException e ) { LOG.error( "鏈接建立失敗，發生 IOException , e " + e.getMessage(), e ); } }

 

二、建立節點

    /** * <p>建立zNode節點, String create(path<節點路徑>, data[]<節點內容>, List(ACL訪問控制列表), CreateMode<zNode建立類型>) </p><br/> * <pre> * 節點建立類型(CreateMode) * 一、PERSISTENT:持久化節點 * 二、PERSISTENT_SEQUENTIAL:順序自動編號持久化節點，這種節點會根據當前已存在的節點數自動加 1 * 三、EPHEMERAL:臨時節點客戶端,session超時這類節點就會被自動刪除 * 四、EPHEMERAL_SEQUENTIAL:臨時自動編號節點 * </pre> * @param path zNode節點路徑 * @param data zNode數據內容 * @return 建立成功返回true, 反之返回false. */
    public boolean createPath( String path, String data ) { try { String zkPath =  this.zk.create(path, data.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT); LOG.info( "節點建立成功, Path: " + zkPath + ", content: " + data ); return true; } catch ( KeeperException e ) { LOG.error( "節點建立失敗, 發生KeeperException! path: " + path + ", data:" + data + ", errMsg:" + e.getMessage(), e ); } catch ( InterruptedException e ) { LOG.error( "節點建立失敗, 發生 InterruptedException! path: " + path + ", data:" + data + ", errMsg:" + e.getMessage(), e ); } return false; }

三、刪除節點

    /** * <p>刪除一個zMode節點, void delete(path<節點路徑>, stat<數據版本號>)</p><br/> * <pre> * 說明 * 一、版本號不一致,沒法進行數據刪除操做. * 二、若是版本號與znode的版本號不一致,將沒法刪除,是一種樂觀加鎖機制;若是將版本號設置爲-1,不會去檢測版本,直接刪除. * </pre> * @param path zNode節點路徑 * @return 刪除成功返回true,反之返回false. */
    public boolean deletePath( String path ){ try { this.zk.delete(path,-1); LOG.info( "節點刪除成功, Path: " + path); return true; } catch ( KeeperException e ) { LOG.error( "節點刪除失敗, 發生KeeperException! path: " + path + ", errMsg:" + e.getMessage(), e ); } catch ( InterruptedException e ) { LOG.error( "節點刪除失敗, 發生 InterruptedException! path: " + path + ", errMsg:" + e.getMessage(), e ); } return false; }

四、節點賦值/更新節點

    /** * <p>更新指定節點數據內容, Stat setData(path<節點路徑>, data[]<節點內容>, stat<數據版本號>)</p> * <pre> * 設置某個znode上的數據時若是爲-1，跳過版本檢查 * </pre> * @param path zNode節點路徑 * @param data zNode數據內容 * @return 更新成功返回true,返回返回false */
    public boolean writeData( String path, String data){ try { Stat stat = this.zk.setData(path, data.getBytes(), -1); LOG.info( "更新數據成功, path：" + path + ", stat: " + stat ); return true; } catch (KeeperException e) { LOG.error( "更新數據失敗, 發生KeeperException! path: " + path + ", data:" + data + ", errMsg:" + e.getMessage(), e ); } catch (InterruptedException e) { LOG.error( "更新數據失敗, 發生InterruptedException! path: " + path + ", data:" + data + ", errMsg:" + e.getMessage(), e ); } return false; }

五、讀取節點值

    /** * <p>讀取指定節點數據內容,byte[] getData(path<節點路徑>, watcher<監視器>, stat<數據版本號>)</p> * @param path zNode節點路徑 * @return 節點存儲的值,有值返回,無值返回null */
    public String readData( String path ){ String data = null; try { data = new String( this.zk.getData( path, false, null ) ); LOG.info( "讀取數據成功, path:" + path + ", content:" + data); } catch (KeeperException e) { LOG.error( "讀取數據失敗,發生KeeperException! path: " + path + ", errMsg:" + e.getMessage(), e ); } catch (InterruptedException e) { LOG.error( "讀取數據失敗,發生InterruptedException! path: " + path + ", errMsg:" + e.getMessage(), e ); } return data; }

六、判斷節點是否存在

    /** * <p>判斷某個zNode節點是否存在, Stat exists(path<節點路徑>, watch<並設置是否監控這個目錄節點，這裏的 watcher 是在建立 ZooKeeper 實例時指定的 watcher>)</p> * @param path zNode節點路徑 * @return 存在返回true,反之返回false */
    public boolean isExists( String path ){ try { Stat stat = this.zk.exists( path, false ); return null != stat; } catch (KeeperException e) { LOG.error( "讀取數據失敗,發生KeeperException! path: " + path + ", errMsg:" + e.getMessage(), e ); } catch (InterruptedException e) { LOG.error( "讀取數據失敗,發生InterruptedException! path: " + path + ", errMsg:" + e.getMessage(), e ); } return false; }

七、獲取某個節點下的子節點

    /** * <p>獲取某個節點下的全部子節點,List getChildren(path<節點路徑>, watcher<監視器>)該方法有多個重載</p> * @param path zNode節點路徑 * @return 子節點路徑集合 說明,這裏返回的值爲節點名 * <pre> * eg. * /node * /node/child1 * /node/child2 * getChild( "node" )戶的集合中的值爲["child1","child2"] * </pre> * * * * @throws KeeperException * @throws InterruptedException */
    public List<String> getChild( String path ){ try{ List<String> list=this.zk.getChildren( path, false ); if(list.isEmpty()){ LOG.info( "中沒有節點" + path ); } return list; }catch (KeeperException e) { LOG.error( "讀取子節點數據失敗,發生KeeperException! path: " + path + ", errMsg:" + e.getMessage(), e ); } catch (InterruptedException e) { LOG.error( "讀取子節點數據失敗,發生InterruptedException! path: " + path + ", errMsg:" + e.getMessage(), e ); } return null; }

八、釋放連接

  /** * 關閉ZK鏈接 */
    public void releaseConnection() { if ( null != zk ) { try { this.zk.close(); } catch ( InterruptedException e ) { LOG.error("release connection error ," + e.getMessage() ,e); } } }

轉載請註明出處:[http://www.cnblogs.com/dennisit/p/4340688.html]