com.sun.sgs.impl.service.nodemap.affinity.dlpa.graph
Interface DLPAGraphBuilder

All Superinterfaces:

AffinityGraphBuilder

All Known Implementing Classes:

BipartiteGraphBuilder, WeightedGraphBuilder

public interface DLPAGraphBuilder
extends AffinityGraphBuilder

Graph builder interface for use with the distributed label propagation algorithm implementation. It includes necessary additional information for that algorithm (object use information and cache conflicts, used to find graph links to other nodes), as well as a way to remove failed nodes.

Method Summary

Map<Long,Map<Object,Long>>	getConflictMap() Returns a map of detected cross node data conflicts.
Map<Object,Map<Identity,Long>>	getObjectUseMap() Returns a map of local object uses to the identities that used the objects, and a count of the number of uses.
void	removeNode(long nodeId) Note that a node has failed.

Methods inherited from interface com.sun.sgs.impl.service.nodemap.affinity.graph.AffinityGraphBuilder

disable, enable, getAffinityGraph, getAffinityGroupFinder, getVertex, shutdown, updateGraph

Method Detail

getObjectUseMap

Map<Object,Map<Identity,Long>> getObjectUseMap()

Returns a map of local object uses to the identities that used the objects, and a count of the number of uses. An empty map will be returned if there are no object uses.

Returns:

the map of local object uses

getConflictMap

Map<Long,Map<Object,Long>> getConflictMap()

Returns a map of detected cross node data conflicts. Conflicts occur when an object is in use by the current node but is needed by another node. This is a map of node IDs (the nodes requesting the object) to object IDs, and a count of the number of conflicts on the object with that node. An empty map will be returned if there are no conflicts. If more than one node needs an object at about the same time, it is only required that one node be recorded as a conflict.

Returns:

the map of detected cross node data conflicts

removeNode

void removeNode(long nodeId)

Note that a node has failed. Does nothing if the nodeId is unknown or has already been noted as failed.

Parameters:

nodeId - the id of the failed node