org.gridgain.grid.kernal.processors.affinity

Class GridAffinityAssignmentCache

java.lang.Object

org.gridgain.grid.kernal.processors.affinity.GridAffinityAssignmentCache

public class GridAffinityAssignmentCache
extends Object

Affinity cached function.

Constructor Summary

Constructors

Constructor and Description
GridAffinityAssignmentCache(GridCacheContext ctx, String cacheName, GridCacheAffinityFunction aff, GridCacheAffinityKeyMapper affMapper, int backups) Constructs affinity cached calculations.

Method Summary

Methods

Modifier and Type	Method and Description
List<List<GridNode>>	assignments(long topVer)
Set<Integer>	backupPartitions(UUID nodeId, long topVer) Get backup partitions for specified node ID.
List<List<GridNode>>	calculate(long topVer, GridDiscoveryEvent discoEvt) Calculates affinity cache for given topology version.
void	cleanUpCache(long topVer) Clean up outdated cache items.
void	initialize(long topVer, List<List<GridNode>> affAssignment) Initializes affinity with given topology version and assignment.
long	lastVersion()
Collection<GridNode>	nodes(int part, long topVer) Gets affinity nodes for specified partition.
int	partition(Object key) NOTE: Use this method always when you need to calculate partition id for a key provided by user.
int	partitions()
Set<Integer>	primaryPartitions(UUID nodeId, long topVer) Get primary partitions for specified node ID.
GridFuture<Long>	readyFuture(long topVer) Gets future that will be completed after topology with version topVer is calculated.

Methods inherited from class java.lang.Object

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

Constructor Detail

GridAffinityAssignmentCache

public GridAffinityAssignmentCache(GridCacheContext ctx,
                           String cacheName,
                           GridCacheAffinityFunction aff,
                           GridCacheAffinityKeyMapper affMapper,
                           int backups)

Constructs affinity cached calculations.

Parameters:

ctx - Kernal context.

cacheName - Cache name.

aff - Affinity function.

affMapper - Affinity key mapper.

Method Detail

initialize

public void initialize(long topVer,
              List<List<GridNode>> affAssignment)

Initializes affinity with given topology version and assignment. The assignment is calculated on remote nodes and brought to local node on partition map exchange.

Parameters:

topVer - Topology version.

affAssignment - Affinity assignment for topology version.

calculate

public List<List<GridNode>> calculate(long topVer,
                             GridDiscoveryEvent discoEvt)

Calculates affinity cache for given topology version.

Parameters:

topVer - Topology version to calculate affinity cache for.

discoEvt - Discovery event that caused this topology version change.

lastVersion

public long lastVersion()

Returns:

Last calculated affinity version.

cleanUpCache

public void cleanUpCache(long topVer)

Clean up outdated cache items.

Parameters:

topVer - Actual topology version, older versions will be removed.

assignments

public List<List<GridNode>> assignments(long topVer)

Parameters:

topVer - Topology version.

Returns:

Affinity assignment.

readyFuture

public GridFuture<Long> readyFuture(long topVer)

Gets future that will be completed after topology with version topVer is calculated.

Parameters:

topVer - Topology version to await for.

Returns:

Future that will be completed after affinity for topology version topVer is calculated.

partitions

public int partitions()

Returns:

Partition count.

partition

public int partition(Object key)

NOTE: Use this method always when you need to calculate partition id for a key provided by user. It's required since we should apply affinity mapper logic in order to find a key that will eventually be passed to affinity function.

Parameters:

key - Key.

Returns:

Partition.

nodes

public Collection<GridNode> nodes(int part,
                         long topVer)

Gets affinity nodes for specified partition.

Parameters:

part - Partition.

topVer - Topology version.

Returns:

Affinity nodes.

primaryPartitions

public Set<Integer> primaryPartitions(UUID nodeId,
                             long topVer)

Get primary partitions for specified node ID.

Parameters:

nodeId - Node ID to get primary partitions for.

topVer - Topology version.

Returns:

Primary partitions for specified node ID.

backupPartitions

public Set<Integer> backupPartitions(UUID nodeId,
                            long topVer)

Get backup partitions for specified node ID.

Parameters:

nodeId - Node ID to get backup partitions for.

topVer - Topology version.

Returns:

Backup partitions for specified node ID.