com.hazelcast.spi.impl.operationservice.impl.operations

Class PartitionIteratingOperation

java.lang.Object

com.hazelcast.spi.Operation

com.hazelcast.spi.impl.operationservice.impl.operations.PartitionIteratingOperation

All Implemented Interfaces:

DataSerializable, IdentifiedDataSerializable

public final class PartitionIteratingOperation
extends Operation
implements IdentifiedDataSerializable

Executes Operations on one or more partitions.

THe execution used to be synchronous; so the thread executing this PartitionIteratingOperation would block till all the child requests are done. In 3.8 this is made asynchronous so that the thread isn't consumed and available for other tasks. On each partition operation an OperationResponseHandler is set, that sends the result to the caller when all responses have completed.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PartitionIteratingOperation.PartitionResponse

Field Summary

Fields inherited from class com.hazelcast.spi.Operation

GENERIC_PARTITION_ID

Constructor Summary

Constructors

Constructor and Description
PartitionIteratingOperation()
PartitionIteratingOperation(OperationFactory operationFactory, int[] partitions)

Method Summary

Modifier and Type	Method and Description
int	getFactoryId() Returns DataSerializableFactory factory ID for this class.
int	getId() Returns type identifier for this class.
OperationFactory	getOperationFactory()
void	onExecutionFailure(Throwable cause) Called when an Exception/Error is thrown during operation execution.
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.
protected void	writeInternal(ObjectDataOutput out)

Methods inherited from class com.hazelcast.spi.Operation

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

Methods inherited from class java.lang.Object

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

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

readData, writeData

Constructor Detail

PartitionIteratingOperation

public PartitionIteratingOperation()

PartitionIteratingOperation

public PartitionIteratingOperation(OperationFactory operationFactory,
                                   int[] partitions)

Parameters:

operationFactory - operation factory to use

partitions - partitions to invoke on

Method Detail

getOperationFactory

public OperationFactory getOperationFactory()

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

run

public void run()
         throws Exception

Overrides:

run in class Operation

Throws:

Exception

onExecutionFailure

public void onExecutionFailure(Throwable cause)

Description copied from class: Operation

Called when an Exception/Error is thrown during operation execution.

By default this method does nothing. Operation implementations can override this behaviour due to their needs.

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

Overrides:

onExecutionFailure in class Operation

Parameters:

cause - Exception/Error thrown during operation execution

getFactoryId

public int getFactoryId()

Description copied from interface: IdentifiedDataSerializable

Returns DataSerializableFactory factory ID for this class.

Specified by:

getFactoryId in interface IdentifiedDataSerializable

Returns:

factory ID

getId

public int getId()

Description copied from interface: IdentifiedDataSerializable

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

Specified by:

getId in interface IdentifiedDataSerializable

Returns:

type ID

writeInternal

protected void writeInternal(ObjectDataOutput out)
                      throws IOException

Overrides:

writeInternal in class Operation

Throws:

IOException

readInternal

protected void readInternal(ObjectDataInput in)
                     throws IOException

Overrides:

readInternal in class Operation

Throws:

IOException

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.