public abstract class NodeUI extends Object implements Serializable, Comparable
A Unique Identifier for a Node.
This class is different from NodeID
in that it does not describe the
Node's location.
Implementations of this class should provide a constructor that takes a
String
parameter which is in the format of the String
returned from the getImplStringForm()
method.
Constructor and Description |
---|
NodeUI() |
Modifier and Type | Method and Description |
---|---|
protected abstract boolean |
checkEqual(NodeUI other)
An abstract method to be implemented to return whether another
NodeUI object is equal to this instance. |
int |
compareTo(Object o)
Compares this
NodeUI with another object. |
static NodeUI |
createFromStringForm(String stringForm)
Creates a NodeUI from a String in the format of that returned from the
getImplStringForm() method. |
boolean |
equals(Object o)
Compares this
NodeUI with another object. |
protected abstract String |
getComparisonString()
This is an abstract method that should be implemented to return a
String that can be used by the compareTo(Object)
method in order to compare two NodeUI objects. |
protected abstract String |
getImplStringForm()
Returns a
String that can be supplied to the
static createFromStringForm(String) method in order to
create an equal NodeUI object. |
abstract int |
hashCode()
Returns an
int hash code for this object. |
protected abstract String getImplStringForm()
String
that can be supplied to the
static createFromStringForm(String)
method in order to
create an equal NodeUI
object.String
containing the necessary information to recreate this NodeUI
object.public static final NodeUI createFromStringForm(String stringForm)
getImplStringForm()
method.stringForm
- the String
to use in creating the NodeUI
object.NodeUI
object.public final boolean equals(Object o)
NodeUI
with another object.
This method checks that the supplied object is a NodeUI
object
and then calls the implementation of the checkEqual(NodeUI)
method and returns its result value as the result of this method.public final int compareTo(Object o) throws ClassCastException
NodeUI
with another object. This method
calls the implementation of the getComparisonString()
method
on both this NodeUI
object and the NodeUI
object
supplied. The String
class' compareTo(Object)
is
used to perform the comparison. The method is called on the String
returned by this object and the String
returned by the other object
is supplied as the parameter.compareTo
in interface Comparable
o
- another object to compare with this object.int
value that follows the rules of the
compareTo(Object)
method in the String
class.ClassCastException
- if the supplied object is not a NodeUI
object.protected abstract boolean checkEqual(NodeUI other)
NodeUI
object is equal to this instance. If the the
NodeUI
is of a different implementation class, the method
should return false
.other
- a NodeUI
to compare with this NodeUI
.true
iff the supplied NodeUI
is equal to this one.protected abstract String getComparisonString()
String
that can be used by the compareTo(Object)
method in order to compare two NodeUI
objects.
Two NodeUI
objects should return equal
String
objects iff the two NodeUI
objects are equal.String
that follows the above rules.Copyright © 1996–2014. All rights reserved.