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
CallStatus	call() Call the operation and returns the CallStatus.
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)
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, executedLocally, getCallerAddress, getCallerUuid, getCallId, getCallTimeout, getConnection, getInvocationTime, getLogger, getNodeEngine, getOperationResponseHandler, getPartitionId, getReplicaIndex, getResponse, getService, getServiceName, getWaitTimeout, isUrgent, logError, onInvocationException, onSetCallId, readData, requiresExplicitServiceName, returnsResponse, run, 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()

call

public CallStatus call()

Description copied from class: Operation

Call the operation and returns the CallStatus. An Operation should either implement call or run; not both. If run is implemented, then the system remains backwards compatible to prevent making massive code changes while adding this feature. In the future all Operation.run() methods will be replaced by call methods. The call method looks very much like the Operation.run() method and it is very close to Runnable.run() and Callable.call(). The main difference between a run and call, is that the returned CallStatus from the call can tell something about the actual execution. For example it could tell that some waiting is required in case of a BlockingOperation. Or that the actual execution work is offloaded to some executor in case of an Offloadable EntryOperation. In the future new types of CallStatus are expected to be added, e.g. for interleaving. In the future it is very likely that for regular Operation that want to return a concrete response, the actual response can be returned directly. In this case we'll change the return type to Object to prevent forcing the response to be wrapped in a CallStatus.DONE_RESPONSE monad since that would force additional litter to be created.

Overrides:

call in class Operation

Returns:

the CallStatus.

See Also:

Operation.run()

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 according 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 to always 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.