com.hazelcast.map.impl.query

Class QueryOperation

java.lang.Object

com.hazelcast.spi.impl.operationservice.Operation

com.hazelcast.spi.impl.operationservice.AbstractNamedOperation

com.hazelcast.map.impl.query.QueryOperation

All Implemented Interfaces:

DataSerializable, IdentifiedDataSerializable, AllowedDuringPassiveState, NamedOperation, ReadonlyOperation

public class QueryOperation
extends AbstractNamedOperation
implements ReadonlyOperation

Field Summary

Fields inherited from class com.hazelcast.spi.impl.operationservice.AbstractNamedOperation

name

Fields inherited from class com.hazelcast.spi.impl.operationservice.Operation

GENERIC_PARTITION_ID

Constructor Summary

Constructors

Constructor and Description
QueryOperation()
QueryOperation(Query query)

Method Summary

Modifier and Type	Method and Description
CallStatus	call() Call the operation and returns the CallStatus.
int	getClassId() Returns type identifier for this class.
int	getFactoryId() Returns DataSerializableFactory factory ID for this class.
Object	getResponse() Called if and only if Operation.returnsResponse() returned true, shortly after Operation.run() returns.
void	onExecutionFailure(Throwable e) Called when an Exception/Error is thrown during operation execution.
ExceptionAction	onInvocationException(Throwable throwable) Called when an Exception/Error is thrown during an invocation.
protected void	readInternal(ObjectDataInput in)
protected void	writeInternal(ObjectDataOutput out)

Methods inherited from class com.hazelcast.spi.impl.operationservice.AbstractNamedOperation

getName, toString

Methods inherited from class com.hazelcast.spi.impl.operationservice.Operation

afterRun, beforeRun, executedLocally, getCallerAddress, getCallerUuid, getCallId, getCallTimeout, getClientCallId, getConnection, getInvocationTime, getLogger, getNodeEngine, getOperationResponseHandler, getPartitionId, getReplicaIndex, getService, getServiceName, getWaitTimeout, isUrgent, logError, onSetCallId, readData, requiresExplicitServiceName, returnsResponse, run, sendResponse, setCallerUuid, setClientCallId, 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

QueryOperation

public QueryOperation()

QueryOperation

public QueryOperation(Query query)

Method Detail

call

public CallStatus call()
                throws Exception

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.

Throws:

Exception - if something failed while executing 'call'.

See Also:

Operation.run()

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, it will retry or fail according to returned ExceptionAction.

This method is called on caller side of the invocation.

Overrides:

onInvocationException in class Operation

Parameters:

throwable - Exception/Error thrown during invocation

Returns:

ExceptionAction

onExecutionFailure

public void onExecutionFailure(Throwable e)

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:

e - Exception/Error thrown during operation execution

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

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

getClassId

public int getClassId()

Description copied from interface: IdentifiedDataSerializable

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

Specified by:

getClassId in interface IdentifiedDataSerializable

Returns:

type ID

writeInternal

protected void writeInternal(ObjectDataOutput out)
                      throws IOException

Overrides:

writeInternal in class AbstractNamedOperation

Throws:

IOException

readInternal

protected void readInternal(ObjectDataInput in)
                     throws IOException

Overrides:

readInternal in class AbstractNamedOperation

Throws:

IOException