com.hazelcast.cache.impl.operation

Class CachePutIfAbsentOperation

java.lang.Object

com.hazelcast.spi.Operation

com.hazelcast.spi.impl.AbstractNamedOperation

com.hazelcast.cache.impl.operation.AbstractMutatingCacheOperation

com.hazelcast.cache.impl.operation.CachePutIfAbsentOperation

All Implemented Interfaces:

MutableOperation, DataSerializable, IdentifiedDataSerializable, BackupAwareOperation, MutatingOperation, NamedOperation, PartitionAwareOperation, ServiceNamespaceAware

public class CachePutIfAbsentOperation
extends AbstractMutatingCacheOperation

Operation implementation for calling ICacheRecordStore.putIfAbsent(Data, Object, ExpiryPolicy, String, int).

See Also:

ICacheRecordStore.putIfAbsent(Data, Object, ExpiryPolicy, String, int)

Field Summary

Fields

Modifier and Type	Field and Description
protected CacheRecord	backupRecord
protected ICacheRecordStore	cache
protected ICacheService	cacheService
protected Data	key
protected Object	response
protected CacheWanEventPublisher	wanEventPublisher

Fields inherited from class com.hazelcast.cache.impl.operation.AbstractMutatingCacheOperation

completionId

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

name

Fields inherited from class com.hazelcast.spi.Operation

GENERIC_PARTITION_ID

Fields inherited from interface com.hazelcast.cache.impl.operation.MutableOperation

IGNORE_COMPLETION

Constructor Summary

Constructors

Constructor and Description
CachePutIfAbsentOperation()
CachePutIfAbsentOperation(String name, Data key, Data value, javax.cache.expiry.ExpiryPolicy expiryPolicy, int completionId)

Method Summary

Modifier and Type	Method and Description
void	afterRun()
void	beforeRun()
int	getAsyncBackupCount()
Operation	getBackupOperation() Creates the BackupOperation responsible for making the backup.
int	getFactoryId() Returns DataSerializableFactory factory id for this class.
int	getId() Returns type identifier for this class.
Object	getResponse()
String	getServiceName()
ObjectNamespace	getServiceNamespace() Returns the ServiceNamespace which this object belongs to.
int	getSyncBackupCount()
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)
void	run()
boolean	shouldBackup() Checks if a backup needs to be made.
protected void	writeInternal(ObjectDataOutput out)

Methods inherited from class com.hazelcast.cache.impl.operation.AbstractMutatingCacheOperation

getCompletionId, setCompletionId

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

getName, toString

Methods inherited from class com.hazelcast.spi.Operation

executedLocally, getCallerAddress, getCallerUuid, getCallId, getCallTimeout, getConnection, getInvocationTime, getLogger, getNodeEngine, getOperationResponseHandler, getPartitionId, getReplicaIndex, getService, getWaitTimeout, isUrgent, onExecutionFailure, onSetCallId, readData, returnsResponse, 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.spi.BackupAwareOperation

getAsyncBackupCount, getSyncBackupCount

Methods inherited from interface com.hazelcast.spi.PartitionAwareOperation

getPartitionId

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

readData, writeData

Field Detail

key

protected Data key

response

protected Object response

cache

protected transient ICacheRecordStore cache

backupRecord

protected transient CacheRecord backupRecord

cacheService

protected transient ICacheService cacheService

wanEventPublisher

protected transient CacheWanEventPublisher wanEventPublisher

Constructor Detail

CachePutIfAbsentOperation

public CachePutIfAbsentOperation()

CachePutIfAbsentOperation

public CachePutIfAbsentOperation(String name,
                                 Data key,
                                 Data value,
                                 javax.cache.expiry.ExpiryPolicy expiryPolicy,
                                 int completionId)

Method Detail

run

public void run()
         throws Exception

Specified by:

run in class Operation

Throws:

Exception

afterRun

public void afterRun()
              throws Exception

Overrides:

afterRun in class Operation

Throws:

Exception

shouldBackup

public boolean shouldBackup()

Description copied from interface: BackupAwareOperation

Checks if a backup needs to be made.

If a call has not made any change, e.g. an AtomicLong increment with 0, no backup needs to be made.

Returns:

true if a backup needs to be made, false otherwise.

getBackupOperation

public Operation getBackupOperation()

Description copied from interface: BackupAwareOperation

Creates the BackupOperation responsible for making the backup.

Returns:

the created BackupOperation responsible for making the backup.

writeInternal

protected void writeInternal(ObjectDataOutput out)
                      throws IOException

Overrides:

writeInternal in class AbstractMutatingCacheOperation

Throws:

IOException

readInternal

protected void readInternal(ObjectDataInput in)
                     throws IOException

Overrides:

readInternal in class AbstractMutatingCacheOperation

Throws:

IOException

getId

public int getId()

Description copied from interface: IdentifiedDataSerializable

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

Returns:

type id

getServiceName

public String getServiceName()

Overrides:

getServiceName in class Operation

beforeRun

public void beforeRun()
               throws Exception

Overrides:

beforeRun in class Operation

Throws:

Exception

getResponse

public final Object getResponse()

Overrides:

getResponse in class Operation

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.

Overrides:

onInvocationException in class Operation

Parameters:

throwable - Exception/Error thrown during invocation

Returns:

ExceptionAction

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

getServiceNamespace

public ObjectNamespace getServiceNamespace()

Description copied from interface: ServiceNamespaceAware

Returns the ServiceNamespace which this object belongs to.

Specified by:

getServiceNamespace in interface ServiceNamespaceAware

Returns:

service namespace

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

getSyncBackupCount

public final int getSyncBackupCount()

getAsyncBackupCount

public final int getAsyncBackupCount()