ibis.ipl
Class IbisIdentifier

java.lang.Object
  ibis.ipl.IbisIdentifier

All Implemented Interfaces:

java.io.Serializable

public abstract class IbisIdentifier

extends java.lang.Object

implements java.io.Serializable

Identifies an Ibis on the network. Be careful, classes implementing this abstract class should override the methods equals() and hashCode(). note: if an IbisIdentifier is sent over the network, it is not guaranteed that the object on the remote side will be a new one. This allows the Ibis implementation to cache IbisIdentifiers.

See Also:

Serialized Form

Method Summary

java.lang.String	cluster() Returns the name of the virtual or physical cluster this Ibis belongs to.
boolean	equals(java.lang.Object o) Compares two Ibis identifiers.
void	free() Releases any resources held by the Ibis identifier.
int	hashCode() Computes the hashcode.
java.lang.String	name() Deprecated. Use toString() instead.
java.lang.String	toString() Returns a name uniquely identifying the Ibis instance to which this IbisIdentifier refers.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

equals

public boolean equals(java.lang.Object o)

Compares two Ibis identifiers. Note: should be redefined by all Ibis implementations.

Throws:

IbisError - is thrown when this method is not redefined by the ibis implementation.

hashCode

public int hashCode()

Computes the hashcode. Note: should be redefined by all Ibis implementations.

Returns:

the hashcode.

Throws:

IbisError - is thrown when this method is not redefined by the ibis implementation.

toString

public java.lang.String toString()

Returns a name uniquely identifying the Ibis instance to which this IbisIdentifier refers.

Returns:

the name of the Ibis instance.

name

public java.lang.String name()

Deprecated. Use toString() instead.

Returns a name uniquely identifying the Ibis instance to which this IbisIdentifier refers.

Returns:

the name of the Ibis instance.

cluster

public java.lang.String cluster()

Returns the name of the virtual or physical cluster this Ibis belongs to. If not set in the System property, it is "unknown".

Returns:

the cluster name.

free

public void free()

Releases any resources held by the Ibis identifier. The default does nothing.