dunit

Class Host

java.lang.Object

dunit.Host

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

HostImpl

public abstract class Host
extends java.lang.Object
implements java.io.Serializable

This class represents a host on which a remote method may be invoked. It provides access to the VMs and GemFire systems that run on that host.

Additionally, it provides access to the Java RMI registry that runs on the host. By default, an RMI registry is only started on the host on which Hydra's Master VM runs. RMI registries may be started on other hosts via additional Hydra configuration.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.List	hosts The available hosts
protected static int	NO_REGISTRY Indicates an unstarted RMI registry

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Host(java.lang.String hostName) Creates a new Host with the given name

Method Summary

Modifier and Type	Method and Description
protected static void	addHost(Host host) Makes note of a new Host
protected void	addLocator(int pid, java.lang.String systemName, RemoteTestModuleIF client)
protected void	addSystem(java.lang.String name, java.lang.String systemDirectory) Adds a GemFire system with the given system directory to this host.
protected void	addVM(int pid, java.lang.String systemName, RemoteTestModuleIF client) Adds a VM to this Host with the given process id and client record.
boolean	equals(java.lang.Object o) Two Hosts are considered equal if they have the same name.
static Host	getHost(int n) Returns a given host
static int	getHostCount() Returns the number of known hosts
java.lang.String	getHostName() Returns the machine name of this host
static VM	getLocator()
GemFireSystem	getSystem(int n) Returns a GemFire system that runs on this host
int	getSystemCount() Returns the number of GemFire systems that run on this host
VM	getVM(int n) Returns a VM that runs on this host
int	getVMCount() Returns the number of VMs that run on this host
int	hashCode() A Host's hash code is based on the hash code of its name.
GemFireSystem	systemNamed(java.lang.String systemName) Returns the GemFire system with the give name
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

hosts

protected static java.util.List hosts

The available hosts

NO_REGISTRY

protected static int NO_REGISTRY

Indicates an unstarted RMI registry

Constructor Detail

Host

protected Host(java.lang.String hostName)

Creates a new Host with the given name

Method Detail

getHostCount

public static int getHostCount()

Returns the number of known hosts

addHost

protected static void addHost(Host host)

Makes note of a new Host

getHost

public static Host getHost(int n)

Returns a given host

Parameters:

n - A zero-based identifier of the host

Throws:

java.lang.IllegalArgumentException - n is more than the number of hosts

getHostName

public java.lang.String getHostName()

Returns the machine name of this host

getVMCount

public int getVMCount()

Returns the number of VMs that run on this host

getVM

public VM getVM(int n)

Returns a VM that runs on this host

Parameters:

n - A zero-based identifier of the VM

Throws:

java.lang.IllegalArgumentException - n is more than the number of VMs

addVM

protected void addVM(int pid,
                     java.lang.String systemName,
                     RemoteTestModuleIF client)

Adds a VM to this Host with the given process id and client record.

getLocator

public static VM getLocator()

addLocator

protected void addLocator(int pid,
                          java.lang.String systemName,
                          RemoteTestModuleIF client)

getSystemCount

public int getSystemCount()

Returns the number of GemFire systems that run on this host

getSystem

public GemFireSystem getSystem(int n)

Returns a GemFire system that runs on this host

Parameters:

n - A zero-based identifier of the GemFire system

Throws:

java.lang.IllegalArgumentException - n is more than the number of GemFire systems

addSystem

protected void addSystem(java.lang.String name,
                         java.lang.String systemDirectory)

Adds a GemFire system with the given system directory to this host.

systemNamed

public GemFireSystem systemNamed(java.lang.String systemName)

Returns the GemFire system with the give name

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Two Hosts are considered equal if they have the same name.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

A Host's hash code is based on the hash code of its name.

Overrides:

hashCode in class java.lang.Object