org.gridgain.grid.kernal.processors.cache.distributed.dht

Class GridDhtLockFuture<K,V>

java.lang.Object

java.util.concurrent.locks.AbstractOwnableSynchronizer

java.util.concurrent.locks.AbstractQueuedSynchronizer

org.gridgain.grid.util.future.GridFutureAdapter<R>

org.gridgain.grid.util.future.GridCompoundFuture<T,T>

org.gridgain.grid.util.future.GridCompoundIdentityFuture<Boolean>

org.gridgain.grid.kernal.processors.cache.distributed.dht.GridDhtLockFuture<K,V>

All Implemented Interfaces:

Externalizable, Serializable, GridFuture<Boolean>, GridDhtFuture<Boolean>, GridCacheMappedVersion, GridCacheFuture<Boolean>, GridCacheMvccFuture<K,V,Boolean>

public final class GridDhtLockFuture<K,V>
extends GridCompoundIdentityFuture<Boolean>
implements GridCacheMvccFuture<K,V,Boolean>, GridDhtFuture<Boolean>, GridCacheMappedVersion

Cache lock future.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.concurrent.locks.AbstractQueuedSynchronizer

AbstractQueuedSynchronizer.ConditionObject

Field Summary

Fields inherited from class org.gridgain.grid.util.future.GridFutureAdapter

ctx

Constructor Summary

Constructors

Constructor and Description
GridDhtLockFuture() Empty constructor required by Externalizable.
GridDhtLockFuture(GridCacheContext<K,V> cctx, UUID nearNodeId, GridCacheVersion nearLockVer, long topVer, int cnt, boolean read, long timeout, GridDhtTxLocalAdapter<K,V> tx, long threadId, GridPredicate<GridCacheEntry<K,V>>[] filter)

Method Summary

Methods

Modifier and Type	Method and Description
GridCacheMvccCandidate<K>	addEntry(GridDhtCacheEntry<K,V> entry) Adds entry to future.
boolean	cancel() Default no-op implementation that always returns false.
Collection<GridDhtCacheEntry<K,V>>	entries()
Collection<GridDhtCacheEntry<K,V>>	entriesCopy()
GridUuid	futureId()
int	hashCode()
Collection<Integer>	invalidPartitions() Node that future should be able to provide keys to retry before it completes, so it's not necessary to wait till future is done to get retry keys.
void	map()
GridCacheVersion	mappedVersion() Mapping should occur only if this interface returns a non-null value.
void	markNotTrackable() Marks this future as non-trackable.
GridCacheVersion	nearLockVersion()
Collection<? extends GridNode>	nodes()
boolean	onDone(Boolean success, Throwable err) Callback to notify that future is finished.
void	onError(GridDistributedLockCancelledException e)
void	onError(Throwable t)
boolean	onNodeLeft(UUID nodeId) Callback for when node left.
boolean	onOwnerChanged(GridCacheEntryEx<K,V> entry, GridCacheMvccCandidate<K> owner) Callback for whenever entry lock ownership changes.
String	toString()
boolean	trackable()
GridCacheVersion	version()

Methods inherited from class org.gridgain.grid.util.future.GridCompoundFuture

add, addAll, addAll, futures, hasPending, ignoreChildFailures, initialized, markInitialized, pending, reducer, reducer

Methods inherited from class org.gridgain.grid.util.future.GridFutureAdapter

chain, checkValid, concurrentNotify, concurrentNotify, duration, endTime, error, get, get, get, get0, isCancelled, isDone, isFailed, isValid, listenAsync, onCancelled, onDone, onDone, onDone, readExternal, result, startTime, stopListenAsync, syncNotify, syncNotify, tryAcquireShared, tryReleaseShared, writeExternal

Methods inherited from class java.util.concurrent.locks.AbstractQueuedSynchronizer

acquire, acquireInterruptibly, acquireShared, acquireSharedInterruptibly, compareAndSetState, getExclusiveQueuedThreads, getFirstQueuedThread, getQueuedThreads, getQueueLength, getSharedQueuedThreads, getState, getWaitingThreads, getWaitQueueLength, hasContended, hasQueuedPredecessors, hasQueuedThreads, hasWaiters, isHeldExclusively, isQueued, owns, release, releaseShared, setState, tryAcquire, tryAcquireNanos, tryAcquireSharedNanos, tryRelease

Methods inherited from class java.util.concurrent.locks.AbstractOwnableSynchronizer

getExclusiveOwnerThread, setExclusiveOwnerThread

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gridgain.grid.GridFuture

chain, concurrentNotify, concurrentNotify, duration, get, get, get, isCancelled, isDone, listenAsync, startTime, stopListenAsync, syncNotify, syncNotify

Constructor Detail

GridDhtLockFuture

public GridDhtLockFuture()

Empty constructor required by Externalizable.

GridDhtLockFuture

public GridDhtLockFuture(GridCacheContext<K,V> cctx,
                 UUID nearNodeId,
                 GridCacheVersion nearLockVer,
                 long topVer,
                 int cnt,
                 boolean read,
                 long timeout,
                 GridDhtTxLocalAdapter<K,V> tx,
                 long threadId,
                 GridPredicate<GridCacheEntry<K,V>>[] filter)

Parameters:

cctx - Cache context.

nearNodeId - Near node ID.

nearLockVer - Near lock version.

topVer - Topology version.

cnt - Number of keys to lock.

read - Read flag.

timeout - Lock acquisition timeout.

tx - Transaction.

threadId - Thread ID.

filter - Filter.

Method Detail

invalidPartitions

public Collection<Integer> invalidPartitions()

Node that future should be able to provide keys to retry before it completes, so it's not necessary to wait till future is done to get retry keys.

Specified by:

invalidPartitions in interface GridDhtFuture<Boolean>

Returns:

Keys to retry because this node is no longer a primary or backup.

nodes

public Collection<? extends GridNode> nodes()

Specified by:

nodes in interface GridCacheFuture<Boolean>

Returns:

Participating nodes.

version

public GridCacheVersion version()

Specified by:

version in interface GridCacheFuture<Boolean>

Returns:

Future version.

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>

entries

public Collection<GridDhtCacheEntry<K,V>> entries()

Returns:

Entries.

entriesCopy

public Collection<GridDhtCacheEntry<K,V>> entriesCopy()

Returns:

Entries.

futureId

public GridUuid futureId()

Specified by:

futureId in interface GridCacheFuture<Boolean>

Returns:

Future ID.

nearLockVersion

public GridCacheVersion nearLockVersion()

Returns:

Near lock version.

mappedVersion

@Nullable
public GridCacheVersion mappedVersion()

Mapping should occur only if this interface returns a non-null value.

Specified by:

mappedVersion in interface GridCacheMappedVersion

Returns:

Mapped version.

addEntry

@Nullable
public GridCacheMvccCandidate<K> addEntry(GridDhtCacheEntry<K,V> entry)
                                   throws GridCacheEntryRemovedException,
                                          GridDistributedLockCancelledException

Adds entry to future.

Parameters:

entry - Entry to add.

Returns:

Lock candidate.

Throws:

GridCacheEntryRemovedException - If entry was removed.

GridDistributedLockCancelledException - If lock is canceled.

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.

onError

public void onError(GridDistributedLockCancelledException e)

Parameters:

e - Error.

onError

public void onError(Throwable t)

Parameters:

t - Error.

onOwnerChanged

public boolean onOwnerChanged(GridCacheEntryEx<K,V> entry,
                     GridCacheMvccCandidate<K> owner)

Callback for whenever entry lock ownership changes.

Specified by:

onOwnerChanged in interface GridCacheMvccFuture<K,V,Boolean>

Parameters:

entry - Entry whose lock ownership changed.

owner - Owner.

Returns:

True if future cares about this entry.

cancel

public boolean cancel()

Default no-op implementation that always returns false. Futures that do support cancellation should override this method and call GridFutureAdapter.onCancelled() callback explicitly if cancellation indeed did happen.

Specified by:

cancel in interface GridFuture<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(@Nullable
             Boolean success,
             @Nullable
             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.

map

public void map()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class GridCompoundIdentityFuture<Boolean>