com.hazelcast.cluster.impl

Class ClusterServiceImpl

java.lang.Object

com.hazelcast.cluster.impl.ClusterServiceImpl

All Implemented Interfaces:

ClusterService, Cluster, ConnectionListener, CoreService, EventPublishingService<MembershipEvent,MembershipListener>, ManagedService, TransactionalService

public class ClusterServiceImpl
extends Object
implements ClusterService, ConnectionListener, ManagedService, EventPublishingService<MembershipEvent,MembershipListener>, TransactionalService

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME

Constructor Summary

Constructors

Constructor and Description
ClusterServiceImpl(Node node)

Method Summary

Methods

Modifier and Type	Method and Description
String	addMembershipListener(MembershipListener listener) Adds MembershipListener to listen for membership updates.
void	changeClusterState(ClusterState newState) Changes state of the cluster to the given state transactionally.
void	changeClusterState(ClusterState newState, TransactionOptions options) Changes state of the cluster to the given state transactionally.
void	connectionAdded(Connection connection)
void	connectionRemoved(Connection connection)
<T extends TransactionalObject> T	createTransactionalObject(String name, Transaction transaction)
void	dispatchEvent(MembershipEvent event, MembershipListener listener)
ClusterClockImpl	getClusterClock() Returns the ClusterClock of the cluster.
ClusterHeartbeatManager	getClusterHeartbeatManager()
String	getClusterId() Returns UUID for the cluster.
ClusterJoinManager	getClusterJoinManager()
ClusterState	getClusterState() Returns the state of the cluster.
ClusterStateManager	getClusterStateManager()
long	getClusterTime() Returns the cluster-wide time in milliseconds.
Member	getLocalMember() Gets the local member instance.
Address	getMasterAddress() Returns the address of the master member.
MemberImpl	getMember(Address address) Gets the member for the given address.
MemberImpl	getMember(String uuid) Gets the member with the given uuid.
Collection<Address>	getMemberAddresses()
Collection<MemberImpl>	getMemberImpls() Gets the collection of members.
Set<Member>	getMembers() Set of the current members in the cluster.
Collection<Member>	getMembers(MemberSelector selector) Returns a collection of the members that satisfy the given MemberSelector.
Collection<MemberImpl>	getMembersRemovedWhileClusterIsNotActive()
NodeEngineImpl	getNodeEngine()
int	getSize() Gets the current number of members.
int	getSize(MemberSelector selector) Gets the number of members that satisfy the given MemberSelector instance.
Address	getThisAddress() Gets the address of this member.
void	init(NodeEngine nodeEngine, Properties properties) Initializes this ManagedService
void	initialClusterState(ClusterState clusterState)
boolean	isMaster() Checks if this member is the master.
boolean	isMemberRemovedWhileClusterIsNotActive(Address target)
String	membersString()
void	merge(Address newTargetAddress)
void	removeAddress(Address deadAddress)
boolean	removeMembershipListener(String registrationId) Removes the specified MembershipListener.
void	reset() reset this ManagedService back to initial state.
void	rollbackTransaction(String transactionId)
void	sendMemberListToMember(Address target)
void	sendShutdownMessage()
void	setClusterId(String clusterId)
void	shutdown() Changes state of the cluster to the ClusterState.PASSIVE transactionally, then triggers the shutdown process on each node.
void	shutdown(boolean terminate) Shuts down this ManagedService.
void	shutdown(TransactionOptions options) Changes state of the cluster to the ClusterState.PASSIVE transactionally, then triggers the shutdown process on each node.
String	toString()
void	updateMemberAttribute(String uuid, MemberAttributeOperationType operationType, String key, Object value)
void	updateMembers(Collection<MemberInfo> members)

Methods inherited from class java.lang.Object

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

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME

See Also:

Constant Field Values

Constructor Detail

ClusterServiceImpl

public ClusterServiceImpl(Node node)

Method Detail

getClusterClock

public ClusterClockImpl getClusterClock()

Description copied from interface: ClusterService

Returns the ClusterClock of the cluster. The returned value will never be null and will never change.

Specified by:

getClusterClock in interface ClusterService

Returns:

the ClusterClock.

getClusterTime

public long getClusterTime()

Description copied from interface: Cluster

Returns the cluster-wide time in milliseconds.

Cluster tries to keep a cluster-wide time which might be different than the member's own system time. Cluster-wide time is -almost- the same on all members of the cluster.

Specified by:

getClusterTime in interface Cluster

Returns:

cluster-wide time

getClusterId

public String getClusterId()

Description copied from interface: ClusterService

Returns UUID for the cluster.

Specified by:

getClusterId in interface ClusterService

Returns:

unique Id for cluster

setClusterId

public void setClusterId(String clusterId)

init

public void init(NodeEngine nodeEngine,
        Properties properties)

Description copied from interface: ManagedService

Initializes this ManagedService

Specified by:

init in interface ManagedService

Parameters:

nodeEngine - the NodeEngine that this ManagedService belongs to.

properties - the Properties. Can be used to pass settings to the service.

sendMemberListToMember

public void sendMemberListToMember(Address target)

removeAddress

public void removeAddress(Address deadAddress)

merge

public void merge(Address newTargetAddress)

reset

public void reset()

Description copied from interface: ManagedService

reset this ManagedService back to initial state. todo: what is the purpose of reset

Specified by:

reset in interface ManagedService

updateMembers

public void updateMembers(Collection<MemberInfo> members)

updateMemberAttribute

public void updateMemberAttribute(String uuid,
                         MemberAttributeOperationType operationType,
                         String key,
                         Object value)

connectionAdded

public void connectionAdded(Connection connection)

Specified by:

connectionAdded in interface ConnectionListener

connectionRemoved

public void connectionRemoved(Connection connection)

Specified by:

connectionRemoved in interface ConnectionListener

getNodeEngine

public NodeEngineImpl getNodeEngine()

isMemberRemovedWhileClusterIsNotActive

public boolean isMemberRemovedWhileClusterIsNotActive(Address target)

getMembersRemovedWhileClusterIsNotActive

public Collection<MemberImpl> getMembersRemovedWhileClusterIsNotActive()

sendShutdownMessage

public void sendShutdownMessage()

getMember

public MemberImpl getMember(Address address)

Description copied from interface: ClusterService

Gets the member for the given address.

Specified by:

getMember in interface ClusterService

Parameters:

address - the address of the member to lookup.

Returns:

the found member, or null if not found. If address is null, null is returned.

getMember

public MemberImpl getMember(String uuid)

Description copied from interface: ClusterService

Gets the member with the given uuid.

Specified by:

getMember in interface ClusterService

Parameters:

uuid - the uuid of the member

Returns:

the found member, or null if not found. If uuid is null, null is returned.

getMemberImpls

public Collection<MemberImpl> getMemberImpls()

Description copied from interface: ClusterService

Gets the collection of members.

if we take care of the generics.

Specified by:

getMemberImpls in interface ClusterService

Returns:

the collection of member. Null will never be returned.

getMemberAddresses

public Collection<Address> getMemberAddresses()

getMembers

public Set<Member> getMembers()

Description copied from interface: Cluster

Set of the current members in the cluster. The returned set is an immutable set; it can't be modified.

The returned set is backed by an ordered set. Every member in the cluster returns the 'members' in the same order. To obtain the oldest member (the master) in the cluster, you can retrieve the first item in the set using 'getMembers().iterator().next()'.

Specified by:

getMembers in interface Cluster

Returns:

current members in the cluster

getMembers

public Collection<Member> getMembers(MemberSelector selector)

Description copied from interface: ClusterService

Returns a collection of the members that satisfy the given MemberSelector.

Specified by:

getMembers in interface ClusterService

Parameters:

selector - MemberSelector instance to filter members to return

Returns:

members that satisfy the given MemberSelector.

shutdown

public void shutdown(boolean terminate)

Description copied from interface: ManagedService

Shuts down this ManagedService. todo: what is the purpose of the terminate variable.

Specified by:

shutdown in interface ManagedService

Parameters:

terminate - true to shut down the ManagedService

getMasterAddress

public Address getMasterAddress()

Description copied from interface: ClusterService

Returns the address of the master member.

Specified by:

getMasterAddress in interface ClusterService

Returns:

the address of the master member. Could be null if the master is not yet known.

isMaster

public boolean isMaster()

Description copied from interface: ClusterService

Checks if this member is the master.

Specified by:

isMaster in interface ClusterService

Returns:

true if master, false otherwise.

getThisAddress

public Address getThisAddress()

Description copied from interface: ClusterService

Gets the address of this member.

Specified by:

getThisAddress in interface ClusterService

Returns:

the address of this member. The returned value will never be null.

getLocalMember

public Member getLocalMember()

Description copied from interface: ClusterService

Gets the local member instance.

Specified by:

getLocalMember in interface ClusterService

Specified by:

getLocalMember in interface Cluster

Returns:

the local member instance. The returned value will never be null.

getSize

public int getSize()

Description copied from interface: ClusterService

Gets the current number of members.

Specified by:

getSize in interface ClusterService

Returns:

the current number of members.

getSize

public int getSize(MemberSelector selector)

Description copied from interface: ClusterService

Gets the number of members that satisfy the given MemberSelector instance.

Specified by:

getSize in interface ClusterService

Parameters:

selector - MemberSelector instance that filters members to be counted.

Returns:

the number of members that satisfy the given MemberSelector instance.

addMembershipListener

public String addMembershipListener(MembershipListener listener)

Description copied from interface: Cluster

Adds MembershipListener to listen for membership updates.

The addMembershipListener method returns a register-id. This id is needed to remove the MembershipListener using the Cluster.removeMembershipListener(String) method.

If the MembershipListener implements the InitialMembershipListener interface, it will also receive the InitialMembershipEvent.

There is no check for duplicate registrations, so if you register the listener twice, it will get events twice.

Specified by:

addMembershipListener in interface Cluster

Parameters:

listener - membership listener

Returns:

the registration id.

See Also:

Cluster.removeMembershipListener(String)

removeMembershipListener

public boolean removeMembershipListener(String registrationId)

Description copied from interface: Cluster

Removes the specified MembershipListener.

If the same MembershipListener is registered multiple times, it needs to be removed multiple times. This method can safely be called multiple times for the same registration-id; subsequent calls are ignored.

Specified by:

removeMembershipListener in interface Cluster

Parameters:

registrationId - the registrationId of MembershipListener to remove.

Returns:

true if the registration is removed, false otherwise.

See Also:

Cluster.addMembershipListener(MembershipListener)

dispatchEvent

public void dispatchEvent(MembershipEvent event,
                 MembershipListener listener)

Specified by:

dispatchEvent in interface EventPublishingService<MembershipEvent,MembershipListener>

membersString

public String membersString()

getClusterState

public ClusterState getClusterState()

Description copied from interface: Cluster

Returns the state of the cluster.

If cluster state change is in process, ClusterState.IN_TRANSITION will be returned.

This is a local operation, state will be read directly from local member.

Specified by:

getClusterState in interface Cluster

Returns:

state of the cluster

createTransactionalObject

public <T extends TransactionalObject> T createTransactionalObject(String name,
                                                          Transaction transaction)

Specified by:

createTransactionalObject in interface TransactionalService

rollbackTransaction

public void rollbackTransaction(String transactionId)

Specified by:

rollbackTransaction in interface TransactionalService

changeClusterState

public void changeClusterState(ClusterState newState)

Description copied from interface: Cluster

Changes state of the cluster to the given state transactionally. Transaction will be TWO_PHASE and will have 1 durability by default. If you want to override transaction options, use Cluster.changeClusterState(ClusterState, TransactionOptions).

If the given state is already same as current state of the cluster, then this method will have no effect.

If there's an ongoing state change transaction in the cluster, this method will fail immediately with a TransactionException.

If a membership change occurs in the cluster during state change, a new member joins or an existing member leaves, then this method will fail with an IllegalStateException.

If there are ongoing/pending migration/replication operations, because of re-balancing due to member join or leave, then trying to change from ACTIVE to FROZEN or PASSIVE will fail with an IllegalStateException.

If transaction timeouts during state change, then this method will fail with a TransactionException.

Specified by:

changeClusterState in interface Cluster

Parameters:

newState - new state of the cluster

changeClusterState

public void changeClusterState(ClusterState newState,
                      TransactionOptions options)

Description copied from interface: Cluster

Changes state of the cluster to the given state transactionally. Transaction must be a TWO_PHASE transaction.

If the given state is already same as current state of the cluster, then this method will have no effect.

If there's an ongoing state change transaction in the cluster, this method will fail immediately with a TransactionException.

If a membership change occurs in the cluster during state change, a new member joins or an existing member leaves, then this method will fail with an IllegalStateException.

If there are ongoing/pending migration/replication operations, because of re-balancing due to member join or leave, then trying to change from ACTIVE to FROZEN or PASSIVE will fail with an IllegalStateException.

If transaction timeouts during state change, then this method will fail with a TransactionException.

Specified by:

changeClusterState in interface Cluster

Parameters:

newState - new state of the cluster

options - transaction options

shutdown

public void shutdown()

Description copied from interface: Cluster

Changes state of the cluster to the ClusterState.PASSIVE transactionally, then triggers the shutdown process on each node. Transaction will be TWO_PHASE and will have 1 durability by default. If you want to override transaction options, use Cluster.shutdown(TransactionOptions).

If the cluster is already in ClusterState.PASSIVE, shutdown process begins immediately. All the node join / leave rules described in ClusterState.PASSIVE state also applies here.

Any node can start the shutdown process. A shutdown command is sent to other nodes periodically until either all other nodes leave the cluster or a configurable timeout occurs. If some of the nodes do not shutdown before the timeout duration, shutdown can be also invoked on them.

Specified by:

shutdown in interface Cluster

See Also:

com.hazelcast.instance.GroupProperty#CLUSTER_SHUTDOWN_TIMEOUT_SECONDS}, #changeClusterState(ClusterState)}, ClusterState#PASSIVE}

shutdown

public void shutdown(TransactionOptions options)

Description copied from interface: Cluster

Changes state of the cluster to the ClusterState.PASSIVE transactionally, then triggers the shutdown process on each node. Transaction must be a TWO_PHASE transaction.

If the cluster is already in ClusterState.PASSIVE, shutdown process begins immediately. All the node join / leave rules described in ClusterState.PASSIVE state also applies here.

Any node can start the shutdown process. A shutdown command is sent to other nodes periodically until either all other nodes leave the cluster or a configurable timeout occurs. If some of the nodes do not shutdown before the timeout duration, shutdown can be also invoked on them.

Specified by:

shutdown in interface Cluster

Parameters:

options - transaction options

See Also:

com.hazelcast.instance.GroupProperty#CLUSTER_SHUTDOWN_TIMEOUT_SECONDS}, #changeClusterState(ClusterState)}, ClusterState#PASSIVE}

initialClusterState

public void initialClusterState(ClusterState clusterState)

getClusterStateManager

public ClusterStateManager getClusterStateManager()

getClusterJoinManager

public ClusterJoinManager getClusterJoinManager()

getClusterHeartbeatManager

public ClusterHeartbeatManager getClusterHeartbeatManager()

toString

public String toString()

Overrides:

toString in class Object