org.apache.ignite.internal.processors.cache.distributed.near

Class GridNearLockFuture

java.lang.Object

org.apache.ignite.internal.util.future.GridFutureAdapter<R>

org.apache.ignite.internal.util.future.GridCompoundFuture<T,T>

org.apache.ignite.internal.util.future.GridCompoundIdentityFuture<T>

org.apache.ignite.internal.processors.cache.GridCacheCompoundIdentityFuture<Boolean>

org.apache.ignite.internal.processors.cache.distributed.near.GridNearLockFuture

All Implemented Interfaces:

Serializable, IgniteInternalFuture<Boolean>, GridCacheFuture<Boolean>, GridCacheVersionedFuture<Boolean>, IgniteInClosure<IgniteInternalFuture<Boolean>>

public final class GridNearLockFuture
extends GridCacheCompoundIdentityFuture<Boolean>
implements GridCacheVersionedFuture<Boolean>

Cache lock future.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GridNearLockFuture(GridCacheContext<?,?> cctx, Collection<KeyCacheObject> keys, @Nullable GridNearTxLocal tx, boolean read, boolean retval, long timeout, long createTtl, long accessTtl, CacheEntryPredicate[] filter, boolean skipStore, boolean keepBinary, boolean recovery)

Method Summary

Modifier and Type	Method and Description
boolean	cancel() Cancellation has special meaning for lock futures.
void	complete(boolean success)
List<GridDistributedCacheEntry>	entriesCopy()
IgniteUuid	futureId()
int	hashCode()
void	markNotTrackable() Marks this future as non-trackable.
boolean	onDone(Boolean success, Throwable err) Callback to notify that future is finished.
boolean	onNodeLeft(UUID nodeId) Callback for when node left.
boolean	onOwnerChanged(GridCacheEntryEx entry, GridCacheMvccCandidate owner) Callback for whenever entry lock ownership changes.
Set<IgniteTxKey>	requestedKeys()
String	toString()
boolean	trackable()
GridCacheVersion	version()

Methods inherited from class org.apache.ignite.internal.processors.cache.GridCacheCompoundIdentityFuture

duration, onDone, startTime

Methods inherited from class org.apache.ignite.internal.util.future.GridCompoundFuture

add, apply, clear, future, futures, futuresCountNoLock, hasFutures, hasPending, ignoreFailure, initialized, logDebug, logError, markInitialized, processFailure

Methods inherited from class org.apache.ignite.internal.util.future.GridFutureAdapter

chain, chain, error, get, get, get, getUninterruptibly, ignoreInterrupts, isCancelled, isDone, isFailed, listen, logger, onCancelled, onDone, onDone, onDone, reset, result

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.ignite.internal.processors.cache.GridCacheFuture

duration, startTime

Methods inherited from interface org.apache.ignite.internal.IgniteInternalFuture

chain, chain, error, get, get, get, getUninterruptibly, isCancelled, isDone, listen, result

Constructor Detail

GridNearLockFuture

public GridNearLockFuture(GridCacheContext<?,?> cctx,
                          Collection<KeyCacheObject> keys,
                          @Nullable
                          @Nullable GridNearTxLocal tx,
                          boolean read,
                          boolean retval,
                          long timeout,
                          long createTtl,
                          long accessTtl,
                          CacheEntryPredicate[] filter,
                          boolean skipStore,
                          boolean keepBinary,
                          boolean recovery)

Parameters:

cctx - Registry.

keys - Keys to lock.

tx - Transaction.

read - Read flag.

retval - Flag to return value or not.

timeout - Lock acquisition timeout.

createTtl - TTL for create operation.

accessTtl - TTL for read operation.

filter - Filter.

skipStore - skipStore

keepBinary - Keep binary flag.

recovery - Recovery flag.

Method Detail

version

public GridCacheVersion version()

Specified by:

version in interface GridCacheVersionedFuture<Boolean>

Returns:

Future version.

entriesCopy

public List<GridDistributedCacheEntry> entriesCopy()

Returns:

Entries.

futureId

public IgniteUuid futureId()

Specified by:

futureId in interface GridCacheFuture<Boolean>

Returns:

Future ID.

trackable

public boolean trackable()

Specified by:

trackable in interface GridCacheFuture<Boolean>

Returns:

True if future should be tracked.

markNotTrackable

public void markNotTrackable()

Marks this future as non-trackable.

Specified by:

markNotTrackable in interface GridCacheFuture<Boolean>

complete

public void complete(boolean success)

Parameters:

success - Success flag.

onNodeLeft

public boolean onNodeLeft(UUID nodeId)

Description copied from interface: GridCacheFuture

Callback for when node left.

Specified by:

onNodeLeft in interface GridCacheFuture<Boolean>

Parameters:

nodeId - Left node ID

Returns:

True if node was in the list.

requestedKeys

public Set<IgniteTxKey> requestedKeys()

Returns:

Keys for which locks requested from remote nodes but response isn't received.

onOwnerChanged

public boolean onOwnerChanged(GridCacheEntryEx entry,
                              GridCacheMvccCandidate owner)

Callback for whenever entry lock ownership changes.

Specified by:

onOwnerChanged in interface GridCacheVersionedFuture<Boolean>

Parameters:

entry - Entry whose lock ownership changed.

owner - Owner.

Returns:

True if future cares about this entry.

cancel

public boolean cancel()

Cancellation has special meaning for lock futures. It's called then lock must be released on rollback.

Specified by:

cancel in interface IgniteInternalFuture<Boolean>

Overrides:

cancel in class GridCompoundFuture<Boolean,Boolean>

Returns:

True if future was canceled (i.e. was not finished prior to this call).

onDone

public boolean onDone(Boolean success,
                      Throwable err)

Callback to notify that future is finished. Note that if non-null exception is passed in the result value will be ignored.

Overrides:

onDone in class GridFutureAdapter<Boolean>

Parameters:

success - Optional result.

err - Optional error.

Returns:

True if result was set by this call.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class GridCompoundIdentityFuture<Boolean>