org.ow2.proactive.resourcemanager.frontend.topology

Class TopologyImpl

java.lang.Object

org.ow2.proactive.resourcemanager.frontend.topology.TopologyImpl

All Implemented Interfaces:

Serializable, Cloneable, Topology

public class TopologyImpl
extends Object
implements Topology, Cloneable

Class represents hosts topology handled by resource manager.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TopologyImpl()

Method Summary

Modifier and Type	Method and Description
void	addHostTopology(String hostName, InetAddress hostAddress, HashMap<InetAddress,Long> hostTopology) Adds host information to the topology.
Object	clone() Clones the topology object, which is uses for synchronization purposes.
List<Cluster<String>>	clusterize(int numberOfClusters, DistanceFunction distanceFunction) Clustirizes hosts into clusters based on their proximity
Long	getDistance(InetAddress host, InetAddress host2) Returns the distance between 2 hosts identified by their inet addresses.
Long	getDistance(org.objectweb.proactive.core.node.Node node, org.objectweb.proactive.core.node.Node node2) Returns the distance between 2 nodes.
Long	getDistance(String hostName, String hostName2) Returns the distance between 2 hosts identified by their domain names.
Set<InetAddress>	getHosts() Gets the set of hosts handled by resource manager.
HashMap<InetAddress,Long>	getHostTopology(InetAddress hostAddress) Gets the distances associated to the host.
boolean	knownHost(InetAddress hostAddress) Checks if the information about host is presented in the topology records.
boolean	onSameHost(org.objectweb.proactive.core.node.Node node, org.objectweb.proactive.core.node.Node node2) Checks if 2 nodes are on the sane host.
void	removeHostTopology(String hostName, InetAddress hostAddress) Removes all information about host from the topology.

Methods inherited from class java.lang.Object

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

Constructor Detail

TopologyImpl

public TopologyImpl()

Method Detail

getDistance

public Long getDistance(org.objectweb.proactive.core.node.Node node,
                        org.objectweb.proactive.core.node.Node node2)

Returns the distance between 2 nodes.

Specified by:

getDistance in interface Topology

Returns:

the distance between 2 nodes

getDistance

public Long getDistance(InetAddress host,
                        InetAddress host2)

Returns the distance between 2 hosts identified by their inet addresses.

Specified by:

getDistance in interface Topology

Returns:

the distance between 2 nodes

getDistance

public Long getDistance(String hostName,
                        String hostName2)

Returns the distance between 2 hosts identified by their domain names.

Specified by:

getDistance in interface Topology

Returns:

the distance between 2 nodes

onSameHost

public boolean onSameHost(org.objectweb.proactive.core.node.Node node,
                          org.objectweb.proactive.core.node.Node node2)

Checks if 2 nodes are on the sane host.

Specified by:

onSameHost in interface Topology

Returns:

true if 2 nodes are on the same hosts, false otherwise

getHosts

public Set<InetAddress> getHosts()

Gets the set of hosts handled by resource manager.

Specified by:

getHosts in interface Topology

Returns:

the set of hosts handled by resource manager

addHostTopology

public void addHostTopology(String hostName,
                            InetAddress hostAddress,
                            HashMap<InetAddress,Long> hostTopology)

Adds host information to the topology. Pass both name and address of host avoiding to do a conversion inside.

Parameters:

hostName - the name of the host

hostAddress - the address of the host

hostTopology - distances to other hosts

removeHostTopology

public void removeHostTopology(String hostName,
                               InetAddress hostAddress)

Removes all information about host from the topology. As it stores internally names and addresses we do not try to convert one into another (as it may lead to network call) but rather pass them as parameters.

Parameters:

hostName - name of host to be removed

hostAddress - host address to be removed

getHostTopology

public HashMap<InetAddress,Long> getHostTopology(InetAddress hostAddress)

Gets the distances associated to the host. Note that it does not return information about all hosts handled by the resource manager but rather the information about hosts added before the one specified.

Specified by:

getHostTopology in interface Topology

Parameters:

hostAddress - - inet address of the host

Returns:

distances map to nodes added before this one

knownHost

public boolean knownHost(InetAddress hostAddress)

Checks if the information about host is presented in the topology records.

Specified by:

knownHost in interface Topology

Parameters:

hostAddress - the address of the host

Returns:

true if the host is known, false otherwise

clone

public Object clone()

Clones the topology object, which is uses for synchronization purposes.

Overrides:

clone in class Object

clusterize

public List<Cluster<String>> clusterize(int numberOfClusters,
                                        DistanceFunction distanceFunction)

Clustirizes hosts into clusters based on their proximity

Specified by:

clusterize in interface Topology

Parameters:

numberOfClusters - the number of clusters to produce

distanceFunction - the function for distances recalculation

Returns:

the list of host clusters