com.hazelcast.internal.partition.operation

Class MigrationRequestOperation

java.lang.Object

com.hazelcast.spi.Operation

com.hazelcast.internal.partition.operation.MigrationRequestOperation

All Implemented Interfaces:

MigrationCycleOperation, DataSerializable, IdentifiedDataSerializable, AllowedDuringPassiveState, PartitionAwareOperation, UrgentSystemOperation

public class MigrationRequestOperation
extends Operation

Migration request operation used by Hazelcast version 3.9 Sent from the master node to the partition owner. It will perform the migration by preparing the migration operations and sending them to the destination. A response with a value equal to Boolean.TRUE indicates a successful migration. It runs on the migration source and transfers the partition with multiple shots. It divides the partition data into fragments and send a group of fragments within each shot.

Field Summary

Fields

Modifier and Type	Field and Description
protected MigrationInfo	migrationInfo
protected int	partitionStateVersion
protected boolean	success

Fields inherited from class com.hazelcast.spi.Operation

GENERIC_PARTITION_ID

Constructor Summary

Constructors

Constructor and Description
MigrationRequestOperation()
MigrationRequestOperation(MigrationInfo migrationInfo, int partitionStateVersion, boolean fragmentedMigrationEnabled)

Method Summary

Modifier and Type	Method and Description
void	beforeRun() Validates the migration operation: the UUIDs of the node should match the one in the migrationInfo, the cluster should be in ClusterState.ACTIVE and the node started and the partition state version from the sender should match the local partition state version.
int	getFactoryId() Returns DataSerializableFactory factory ID for this class.
int	getId() Returns type identifier for this class.
protected PartitionMigrationEvent	getMigrationEvent() Returns the event which will be forwarded to MigrationAwareServices.
MigrationInfo	getMigrationInfo()
protected InternalMigrationListener.MigrationParticipant	getMigrationParticipantType()
Object	getResponse() Called if and only if Operation.returnsResponse() returned true, shortly after Operation.run() returns.
void	logError(Throwable e) Logs Exception/Error thrown during operation execution.
ExceptionAction	onInvocationException(Throwable throwable) Called when an Exception/Error is thrown during an invocation.
protected void	readInternal(ObjectDataInput in)
boolean	returnsResponse() Method is intended to be subclassed.
void	run()
protected void	toString(StringBuilder sb) A template method allows for additional information to be passed into the Operation.toString() method.
boolean	validatesTarget()
protected void	writeInternal(ObjectDataOutput out)

Methods inherited from class com.hazelcast.spi.Operation

afterRun, call, executedLocally, getCallerAddress, getCallerUuid, getCallId, getCallTimeout, getConnection, getInvocationTime, getLogger, getNodeEngine, getOperationResponseHandler, getPartitionId, getReplicaIndex, getService, getServiceName, getWaitTimeout, isUrgent, onExecutionFailure, onSetCallId, readData, sendResponse, setCallerUuid, setNodeEngine, setOperationResponseHandler, setPartitionId, setReplicaIndex, setService, setServiceName, setValidateTarget, setWaitTimeout, toString, writeData

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.hazelcast.spi.PartitionAwareOperation

getPartitionId

Methods inherited from interface com.hazelcast.nio.serialization.DataSerializable

readData, writeData

Field Detail

migrationInfo

protected MigrationInfo migrationInfo

success

protected boolean success

partitionStateVersion

protected int partitionStateVersion

Constructor Detail

MigrationRequestOperation

public MigrationRequestOperation()

MigrationRequestOperation

public MigrationRequestOperation(MigrationInfo migrationInfo,
                                 int partitionStateVersion,
                                 boolean fragmentedMigrationEnabled)

Method Detail

run

public void run()

Overrides:

run in class Operation

getId

public int getId()

Description copied from interface: IdentifiedDataSerializable

Returns type identifier for this class. It should be unique per DataSerializableFactory.

Returns:

type ID

writeInternal

protected void writeInternal(ObjectDataOutput out)
                      throws IOException

Throws:

IOException

readInternal

protected void readInternal(ObjectDataInput in)
                     throws IOException

Throws:

IOException

getMigrationEvent

protected PartitionMigrationEvent getMigrationEvent()

Returns the event which will be forwarded to MigrationAwareServices.

getMigrationParticipantType

protected InternalMigrationListener.MigrationParticipant getMigrationParticipantType()

onInvocationException

public ExceptionAction onInvocationException(Throwable throwable)

Description copied from class: Operation

Called when an Exception/Error is thrown during an invocation. Invocation process will continue, retry or fail according to returned ExceptionAction result.

This method is called on caller side of the invocation.

Parameters:

throwable - Exception/Error thrown during invocation

Returns:

ExceptionAction

returnsResponse

public boolean returnsResponse()

Description copied from class: Operation

Method is intended to be subclassed. If it returns true, Operation.getResponse() will be called right after Operation.run() method. If it returns false, Operation.sendResponse(Object) must be called later to finish the operation.

In other words, true is for synchronous operation and false is for asynchronous one.

Default implementation is synchronous operation (true).

Overrides:

returnsResponse in class Operation

beforeRun

public final void beforeRun()
                     throws Exception

Validates the migration operation: the UUIDs of the node should match the one in the migrationInfo, the cluster should be in ClusterState.ACTIVE and the node started and the partition state version from the sender should match the local partition state version.

Overrides:

beforeRun in class Operation

Throws:

IllegalStateException - if the UUIDs don't match or if the cluster and node state are not

PartitionStateVersionMismatchException - if the partition versions don't match and this node is not the master node

Exception

getMigrationInfo

public MigrationInfo getMigrationInfo()

getResponse

public Object getResponse()

Description copied from class: Operation

Called if and only if Operation.returnsResponse() returned true, shortly after Operation.run() returns.

Overrides:

getResponse in class Operation

validatesTarget

public final boolean validatesTarget()

Overrides:

validatesTarget in class Operation

logError

public void logError(Throwable e)

Description copied from class: Operation

Logs Exception/Error thrown during operation execution. Operation implementations can override this behaviour due to their needs.

This method is called on node & thread that's executing the operation.

Overrides:

logError in class Operation

Parameters:

e - Exception/Error thrown during operation execution

toString

protected void toString(StringBuilder sb)

Description copied from class: Operation

A template method allows for additional information to be passed into the Operation.toString() method. So an Operation subclass can override this method and add additional debugging content. The default implementation does nothing so one is not forced to provide an empty implementation. It is a good practice always to call the super.toString(stringBuffer) when implementing this method to make sure that the super class can inject content if needed.

Overrides:

toString in class Operation

Parameters:

sb - the StringBuilder to add the debug info to.

getFactoryId

public final int getFactoryId()

Description copied from interface: IdentifiedDataSerializable

Returns DataSerializableFactory factory ID for this class.

Specified by:

getFactoryId in interface IdentifiedDataSerializable

Returns:

factory ID