Package org.apache.activemq.artemis.core.server.cluster.qourum

Class QuorumManager

java.lang.Object

org.apache.activemq.artemis.core.server.cluster.qourum.QuorumManager

All Implemented Interfaces:

ClusterTopologyListener, ActiveMQComponent

public final class QuorumManager
extends Object
implements ClusterTopologyListener, ActiveMQComponent

A QourumManager can be used to register a Quorum to receive notifications about changes to the cluster. A Quorum can then issue a vote to the remaining nodes in a cluster for a specific outcome

Constructor Summary

Constructors

Constructor	Description
QuorumManager(ExecutorService threadPool, ClusterController clusterController)

Method Summary

Modifier and Type	Method	Description
int	getMaxClusterSize()	returns the maximum size this cluster has been.
void	handleQuorumVote(Channel clusterChannel, Packet packet)
boolean	hasLive(String nodeID, int quorumSize, int voteTimeout, TimeUnit voteTimeoutUnit)
boolean	isStarted()	are we started
boolean	isStillLive(String nodeID, TransportConfiguration liveConnector, int quorumSize, int voteTimeout, TimeUnit voteTimeoutUnit)
void	nodeDown(long eventUID, String nodeID)	notify the Quorum of a topology change.
void	nodeUP(TopologyMember topologyMember, boolean last)	called by the ServerLocatorInternal when the topology changes.
void	registerQuorum(Quorum quorum)	registers a Quorum so that it can be notified of changes in the cluster.
void	registerQuorumHandler(QuorumVoteHandler quorumVoteHandler)	called to register vote handlers on the quorum
void	start()	we start by simply creating the server locator and connecting in a separate thread
void	stop()	stops the server locator
String	toString()
void	unRegisterQuorum(Quorum quorum)	unregisters a Quorum.
void	vote(QuorumVote quorumVote)	ask the quorum to vote within a specific quorum.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.activemq.artemis.core.server.ActiveMQComponent

asyncStop

Constructor Detail

QuorumManager

public QuorumManager(ExecutorService threadPool,
                     ClusterController clusterController)

Method Detail

start

public void start()
           throws Exception

we start by simply creating the server locator and connecting in a separate thread

Specified by:

start in interface ActiveMQComponent

Throws:

Exception

stop

public void stop()
          throws Exception

stops the server locator

Specified by:

stop in interface ActiveMQComponent

Throws:

Exception

isStarted

public boolean isStarted()

are we started

Specified by:

isStarted in interface ActiveMQComponent

Returns:

registerQuorum

public void registerQuorum(Quorum quorum)

registers a Quorum so that it can be notified of changes in the cluster.

Parameters:

quorum -

unRegisterQuorum

public void unRegisterQuorum(Quorum quorum)

unregisters a Quorum.

Parameters:

quorum -

nodeUP

public void nodeUP(TopologyMember topologyMember,
                   boolean last)

called by the ServerLocatorInternal when the topology changes. we update the maxClusterSize if needed and inform the Quorum's.

Specified by:

nodeUP in interface ClusterTopologyListener

Parameters:

topologyMember - the topolgy changed

last - if the whole cluster topology is being transmitted (after adding the listener to the cluster connection) this parameter will be true for the last topology

nodeDown

public void nodeDown(long eventUID,
                     String nodeID)

notify the Quorum of a topology change.

Specified by:

nodeDown in interface ClusterTopologyListener

Parameters:

eventUID -

nodeID - the id of the node leaving the cluster

hasLive

public boolean hasLive(String nodeID,
                       int quorumSize,
                       int voteTimeout,
                       TimeUnit voteTimeoutUnit)

isStillLive

public boolean isStillLive(String nodeID,
                           TransportConfiguration liveConnector,
                           int quorumSize,
                           int voteTimeout,
                           TimeUnit voteTimeoutUnit)

getMaxClusterSize

public int getMaxClusterSize()

returns the maximum size this cluster has been.

Returns:

max size

vote

public void vote(QuorumVote quorumVote)

ask the quorum to vote within a specific quorum.

Parameters:

quorumVote - the vote to acquire

registerQuorumHandler

public void registerQuorumHandler(QuorumVoteHandler quorumVoteHandler)

called to register vote handlers on the quorum

Parameters:

quorumVoteHandler - the vote handler

toString

public String toString()

Overrides:

toString in class Object

handleQuorumVote

public void handleQuorumVote(Channel clusterChannel,
                             Packet packet)