io.fabric8.groups.internal

Class ZooKeeperGroup<T extends NodeState>

java.lang.Object

io.fabric8.groups.internal.ZooKeeperGroup<T>

All Implemented Interfaces:

Group<T>, java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

ZooKeeperMultiGroup

public class ZooKeeperGroup<T extends NodeState>
extends java.lang.Object
implements Group<T>

A utility that attempts to keep all data from all children of a ZK path locally cached. This class will watch the ZK path, respond to update/create/delete events, pull down the data, etc. You can register a listener that will get notified when changes occur.

IMPORTANT - it's not possible to stay transactionally in sync. Users of this class must be prepared for false-positives and false-negatives. Additionally, always use the version number when updating data to avoid overwriting another process' change.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.ConcurrentMap<java.lang.String,ChildData<T>>	currentData
static org.codehaus.jackson.map.ObjectMapper	MAPPER
protected SequenceComparator	sequenceComparator

Constructor Summary

Constructors

Constructor and Description
ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client, java.lang.String path, java.lang.Class<T> clazz)
ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client, java.lang.String path, java.lang.Class<T> clazz, java.util.concurrent.ExecutorService executorService)
ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client, java.lang.String path, java.lang.Class<T> clazz, java.util.concurrent.ThreadFactory threadFactory)

Method Summary

Methods

Modifier and Type	Method and Description
void	add(GroupListener<T> listener) Registers a listener which will be called when the cluster membership changes or the group is connected or disconnected.
void	clear() Clears the current data without beginning a new query and without generating any events for listeners.
void	clearAndRefresh() Clear out current data and begin a new query on the path
void	close() Close/end the cache
protected void	doUpdate(T state)
java.util.List<ChildData>	getCurrentData() Return the current data.
ChildData	getCurrentData(java.lang.String fullPath) Return the current data for the given path.
java.lang.String	getId()
org.apache.curator.framework.listen.ListenerContainer<GroupListener<T>>	getListenable() Return the cache listenable
protected void	handleException(java.lang.Throwable e) Default behavior is just to log the exception
boolean	isConnected() Are we connected with the cluster?
boolean	isMaster() Check if we are the master.
T	master() Retrieve the master node.
java.util.Map<java.lang.String,T>	members() Get the list of members connected to this group.
static <T> java.util.Map<java.lang.String,T>	members(org.apache.curator.framework.CuratorFramework curator, java.lang.String path, java.lang.Class<T> clazz)
void	remove(GroupListener<T> listener) Removes a previously added listener.
protected void	remove(java.lang.String fullPath)
java.util.List<T>	slaves() Retrieve the list of slaves.
void	start() Start the cache.
void	update(T state) Update the state of this group member.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAPPER

public static final org.codehaus.jackson.map.ObjectMapper MAPPER

currentData

protected final java.util.concurrent.ConcurrentMap<java.lang.String,ChildData<T extends NodeState>> currentData

sequenceComparator

protected final SequenceComparator sequenceComparator

Constructor Detail

ZooKeeperGroup

public ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client,
              java.lang.String path,
              java.lang.Class<T> clazz)

Parameters:

client - the client

path - path to watch

ZooKeeperGroup

public ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client,
              java.lang.String path,
              java.lang.Class<T> clazz,
              java.util.concurrent.ThreadFactory threadFactory)

Parameters:

client - the client

path - path to watch

threadFactory - factory to use when creating internal threads

ZooKeeperGroup

public ZooKeeperGroup(org.apache.curator.framework.CuratorFramework client,
              java.lang.String path,
              java.lang.Class<T> clazz,
              java.util.concurrent.ExecutorService executorService)

Parameters:

client - the client

path - path to watch

executorService - ExecutorService to use for the ZooKeeperGroup's background thread

Method Detail

start

public void start()

Start the cache. The cache is not started automatically. You must call this method.

Specified by:

start in interface Group<T extends NodeState>

close

public void close()
           throws java.io.IOException

Close/end the cache

Specified by:

close in interface Group<T extends NodeState>

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException - errors

isConnected

public boolean isConnected()

Description copied from interface: Group

Are we connected with the cluster?

Specified by:

isConnected in interface Group<T extends NodeState>

add

public void add(GroupListener<T> listener)

Description copied from interface: Group

Registers a listener which will be called when the cluster membership changes or the group is connected or disconnected.

Specified by:

add in interface Group<T extends NodeState>

remove

public void remove(GroupListener<T> listener)

Description copied from interface: Group

Removes a previously added listener.

Specified by:

remove in interface Group<T extends NodeState>

update

public void update(T state)

Description copied from interface: Group

Update the state of this group member. If the state is null, the member will leave the group. This method can be called even if the group is not started, in which case the state will be stored and updated when the group becomes started.

Specified by:

update in interface Group<T extends NodeState>

Parameters:

state - the new state of this group member

doUpdate

protected void doUpdate(T state)
                 throws java.lang.Exception

Throws:

java.lang.Exception

members

public java.util.Map<java.lang.String,T> members()

Description copied from interface: Group

Get the list of members connected to this group.

Specified by:

members in interface Group<T extends NodeState>

isMaster

public boolean isMaster()

Description copied from interface: Group

Check if we are the master.

Specified by:

isMaster in interface Group<T extends NodeState>

master

public T master()

Description copied from interface: Group

Retrieve the master node.

Specified by:

master in interface Group<T extends NodeState>

slaves

public java.util.List<T> slaves()

Description copied from interface: Group

Retrieve the list of slaves.

Specified by:

slaves in interface Group<T extends NodeState>

getListenable

public org.apache.curator.framework.listen.ListenerContainer<GroupListener<T>> getListenable()

Return the cache listenable

Returns:

listenable

getCurrentData

public java.util.List<ChildData> getCurrentData()

Return the current data. There are no guarantees of accuracy. This is merely the most recent view of the data. The data is returned in sorted order.

Returns:

list of children and data

getCurrentData

public ChildData getCurrentData(java.lang.String fullPath)

Return the current data for the given path. There are no guarantees of accuracy. This is merely the most recent view of the data. If there is no child with that path, null is returned.

Parameters:

fullPath - full path to the node to check

Returns:

data or null

clearAndRefresh

public void clearAndRefresh()
                     throws java.lang.Exception

Clear out current data and begin a new query on the path

Throws:

java.lang.Exception - errors

clear

public void clear()

Clears the current data without beginning a new query and without generating any events for listeners.

handleException

protected void handleException(java.lang.Throwable e)

Default behavior is just to log the exception

Parameters:

e - the exception

remove

protected void remove(java.lang.String fullPath)

members

public static <T> java.util.Map<java.lang.String,T> members(org.apache.curator.framework.CuratorFramework curator,
                                            java.lang.String path,
                                            java.lang.Class<T> clazz)
                                                 throws java.lang.Exception

Throws:

java.lang.Exception

getId

public java.lang.String getId()