(defprotocol ClusterState
 (set-ephemeral-node [this path data])
 (delete-node [this path])
 (create-sequential [this path data])
 (set-data [this path data]) ;; if node does not exist, create persistent with this data 
 (get-data [this path watch?])
 (get-children [this path watch?])
 (mkdirs [this path])
 (close [this])
 (register [this callback])
 (unregister [this id])
 )

(defprotocol StormClusterState
 (assignments [this callback])
 (assignment-info [this storm-id callback])
 (active-storms [this])
 (storm-base [this storm-id callback])
 (get-worker-heartbeat [this storm-id node port])
 (executor-beats [this storm-id executor->node+port])
 (supervisors [this callback])
 (supervisor-info [this supervisor-id]) ;; returns nil if doesn't exist
 (setup-heartbeats! [this storm-id])
 (teardown-heartbeats! [this storm-id])
 (teardown-topology-errors! [this storm-id])
 (heartbeat-storms [this])
 (error-topologies [this])
 (worker-heartbeat! [this storm-id node port info])
 (remove-worker-heartbeat! [this storm-id node port])
 (supervisor-heartbeat! [this supervisor-id info])
 (activate-storm! [this storm-id storm-base])
 (update-storm! [this storm-id new-elems])
 (remove-storm-base! [this storm-id])
 (set-assignment! [this storm-id info])
 (remove-storm! [this storm-id])
 (report-error [this storm-id task-id error])
 (errors [this storm-id task-id])
 (disconnect [this])
 )

(def ASSIGNMENTS-ROOT "assignments")
(def CODE-ROOT "code")
(def STORMS-ROOT "storms")
(def SUPERVISORS-ROOT "supervisors")
(def WORKERBEATS-ROOT "workerbeats")
(def ERRORS-ROOT "errors")

(def ASSIGNMENTS-SUBTREE (str "/" ASSIGNMENTS-ROOT))
(def STORMS-SUBTREE (str "/" STORMS-ROOT))
(def SUPERVISORS-SUBTREE (str "/" SUPERVISORS-ROOT))
(def WORKERBEATS-SUBTREE (str "/" WORKERBEATS-ROOT))
(def ERRORS-SUBTREE (str "/" ERRORS-ROOT))

/-{storm-zk-root}      -- storm在zookeeper上的根目錄(默認(rèn)為/storm)
 |
 |-/assignments      -- topology的任務(wù)分配信息
 |  |
 |  |-/{topology-id}   -- 這個(gè)目錄保存的是每個(gè)topology的assignments信息包括：對(duì)應(yīng)的nimbus上
 |             -- 的代碼目錄,所有task的啟動(dòng)時(shí)間,每個(gè)task與機(jī)器、端口的映射。操作為
 |             -- (assignments)來(lái)獲取所有assignments的值；以及(assignment-info storm-id)
 |             -- 來(lái)得到給定的storm-id對(duì)應(yīng)的AssignmentInfo信息
 |             -- 在A(yíng)ssignmentInfo中存儲(chǔ)的內(nèi)容有:
 |             -- :executor->node+port :executor->start-time-secs :node->host
 |             -- 具體定義在common.clj中的
 |             -- (defrecord Assignment[master-code-dir node->host executor->node+port                  executor->start-time-secs])            
 |
 |-/storms         -- 這個(gè)目錄保存所有正在運(yùn)行的topology的id
 |  |
 |  |
 |  |-/{topology-id}   -- 這個(gè)文件保存這個(gè)topology的一些信息，包括topology的名字，topology開(kāi)始運(yùn)行
 |             -- 的時(shí)間以及這個(gè)topology的狀態(tài)。操作(active-storms),獲得當(dāng)前路徑活躍的下
 |             -- topology數(shù)據(jù)。保存的內(nèi)容參考類(lèi)StormBase；(storm-base storm-id)得到給定的
 |             -- storm-id下的StormBase數(shù)據(jù),具體定義在common.clj中的
 |   -- (defrecord StormBase [storm-name launch-time-secs status num-workers component->executors])
 |
 |-/supervisors      -- 這個(gè)目錄保存所有的supervisor的心跳信息
 |  |            
 |  |
 |  |-/{supervisor-id}  -- 這個(gè)文件保存supervisor的心跳信息包括:心跳時(shí)間，主機(jī)名，這個(gè)supervisor上
 |             -- worker的端口號(hào)，運(yùn)行時(shí)間(具體看SupervisorInfo類(lèi))。操作(supervisors)得到
 |             -- 所有的supervisors節(jié)點(diǎn)；(supervisor-info supervisor-id)得到給定的
 |             -- supervisor-id對(duì)應(yīng)的SupervisorInfo信息；具體定義在common.clj中的
 |              
 |    -- (defrecord SupervisorInfo [time-secs hostname assignment-id used-ports meta scheduler-meta       uptime-secs])
 |
 |-/workerbeats          -- 所有worker的心跳
 |  |
 |  |-/{topology-id}       -- 這個(gè)目錄保存這個(gè)topology的所有的worker的心跳信息
 |    |
 |    |-/{supervisorId-port}  -- worker的心跳信息，包括心跳的時(shí)間，worker運(yùn)行時(shí)間以及一些統(tǒng)計(jì)信息
 |                    
 |                 -- 操作(heartbeat-storms)得到所有有心跳數(shù)據(jù)的topology，
 |                 -- (get-worker-heartbeat storm-id node port)得到具體一個(gè)topology下
 |                 -- 的某個(gè)worker(node:port)的心跳狀況，
 |             -- (executor-beats storm-id executor->node+port)得到一個(gè)executor的心跳狀況
 |
 |-/errors         -- 所有產(chǎn)生的error信息
 |
 |-/{topology-id}      -- 這個(gè)目錄保存這個(gè)topology下面的錯(cuò)誤信息。操作(error-topologies)得到出錯(cuò)
   |           -- 的topology；(errors storm-id component-id)得到
   |           -- 給定的storm-id component-id下的出錯(cuò)信息
   |-/{component-id}