com.hazelcast.cp.internal.datastructures.spi

Class AbstractCPMigrationAwareService

java.lang.Object

com.hazelcast.cp.internal.datastructures.spi.AbstractCPMigrationAwareService

All Implemented Interfaces:

MigrationAwareService

Direct Known Subclasses:

AbstractBlockingService, RaftAtomicValueService, RaftSessionService

public abstract class AbstractCPMigrationAwareService
extends Object
implements MigrationAwareService

Abstract MigrationAwareService implementation to provide partition migration support for CP data structures unsafe mode.

Field Summary

Fields

Modifier and Type	Field and Description
protected NodeEngineImpl	nodeEngine

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractCPMigrationAwareService(NodeEngine nodeEngine)

Method Summary

Modifier and Type	Method and Description
void	beforeMigration(PartitionMigrationEvent event) Called before migration process starts, on both source and destination members.
protected abstract void	clearPartitionReplica(int partitionId)
void	commitMigration(PartitionMigrationEvent event) Commits the migration process for this service, on both source and destination members.
protected abstract int	getBackupCount()
protected abstract Map<CPGroupId,Object>	getSnapshotMap(int partitionId)
Operation	prepareReplicationOperation(PartitionReplicationEvent event) Returns an operation to replicate service data and/or state for a specific partition replica on another cluster member.
void	rollbackMigration(PartitionMigrationEvent event) Rollback the migration process for this service, on both source and destination members.

Methods inherited from class java.lang.Object

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

Field Detail

nodeEngine

protected final NodeEngineImpl nodeEngine

Constructor Detail

AbstractCPMigrationAwareService

protected AbstractCPMigrationAwareService(NodeEngine nodeEngine)

Method Detail

getBackupCount

protected abstract int getBackupCount()

getSnapshotMap

protected abstract Map<CPGroupId,Object> getSnapshotMap(int partitionId)

clearPartitionReplica

protected abstract void clearPartitionReplica(int partitionId)

prepareReplicationOperation

public final Operation prepareReplicationOperation(PartitionReplicationEvent event)

Description copied from interface: MigrationAwareService

Returns an operation to replicate service data and/or state for a specific partition replica on another cluster member.

This method will be called on source member whenever partitioning system requires to copy/replicate a partition replica. Returned operation will be executed on destination member. If operation fails by throwing exception, migration process will fail and will be rolled back.

Returning null is allowed and means service does not have anything to replicate.

Specified by:

prepareReplicationOperation in interface MigrationAwareService

Parameters:

event - replication

Returns:

replication operation or null if nothing will be replicated

beforeMigration

public void beforeMigration(PartitionMigrationEvent event)

Description copied from interface: MigrationAwareService

Called before migration process starts, on both source and destination members.

Service can take actions required before migration. Migration process will block until this method returns. If this method fails by throwing an exception, migration process for specific partition will fail and will be rolled back.

Specified by:

beforeMigration in interface MigrationAwareService

Parameters:

event - migration event

commitMigration

public final void commitMigration(PartitionMigrationEvent event)

Description copied from interface: MigrationAwareService

Commits the migration process for this service, on both source and destination members. This method will be called after all replication operations are executed successfully on destination and master member receives success response from all participants.

Commit is not expected to fail at this point, all exceptions will be suppressed and logged. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.

Specified by:

commitMigration in interface MigrationAwareService

Parameters:

event - migration event

rollbackMigration

public final void rollbackMigration(PartitionMigrationEvent event)

Description copied from interface: MigrationAwareService

Rollback the migration process for this service, on both source and destination members. This method will be called when migration process fails at any moment. Reasons for failure may be an exception thrown on any migration step or failure(s) of any of the migration participants; either master or source or destination.

Rollback is not expected to fail at this point, all exceptions will be suppressed and logged. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.

Specified by:

rollbackMigration in interface MigrationAwareService

Parameters:

event - migration event