rice.pastry.dist
Class DistNodeHandle

java.lang.Object
  java.util.Observable
      rice.p2p.commonapi.NodeHandle
          rice.pastry.NodeHandle
              rice.pastry.dist.DistNodeHandle

All Implemented Interfaces:

java.util.Observer, java.io.Serializable

Direct Known Subclasses:

SocketNodeHandle

public abstract class DistNodeHandle

extends NodeHandle

implements java.util.Observer

Abstract class for handles to "real" remote nodes. This class abstracts out the node handle verification which is necessary in the "real" pastry protocols, since NodeHandles are sent across the wire.

Version:

$Id: DistNodeHandle.java 3274 2006-05-15 16:17:47Z jeffh $

Author:

Alan Mislove

See Also:

Serialized Form

Field Summary

protected java.net.InetSocketAddress	address DESCRIBE THE FIELD
protected int	epoch a unique number matching the liveness of this node this number will be different each time the process is run, but the NodeId can be the same.
protected Id	nodeId DESCRIBE THE FIELD

Fields inherited from class rice.pastry.NodeHandle

LIVENESS_ALIVE, LIVENESS_DEAD, LIVENESS_SUSPECTED, localnode, logger

Fields inherited from class rice.p2p.commonapi.NodeHandle

DECLARED_DEAD, DECLARED_LIVE, PROXIMITY_CHANGED

Constructor Summary

DistNodeHandle(Id nodeId, java.net.InetSocketAddress address)
Constructor

Method Summary

abstract boolean	equals(java.lang.Object obj) Equivalence relation for nodehandles.
java.net.InetSocketAddress	getAddress() Returns the IP address and port of the remote node.
int	getEpoch() Gets the epoch or session identifier of this Pastry node.
Id	getNodeId() Gets the nodeId of this Pastry node.
abstract int	hashCode() Hash codes for node handles.
abstract java.lang.String	toString() Returns a String representation of this DistNodeHandle.

Methods inherited from class rice.pastry.NodeHandle

assertLocalNode, bootstrap, checkLiveness, getId, getLiveness, getLocalNode, isAlive, ping, proximity, receiveMessage, serialize

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Observer

update

Field Detail

nodeId

protected Id nodeId

DESCRIBE THE FIELD

address

protected java.net.InetSocketAddress address

DESCRIBE THE FIELD

epoch

protected int epoch

a unique number matching the liveness of this node this number will be different each time the process is run, but the NodeId can be the same.

Constructor Detail

DistNodeHandle

public DistNodeHandle(Id nodeId,
                      java.net.InetSocketAddress address)

Constructor

Parameters:

nodeId - This node handle's node Id.

address - DESCRIBE THE PARAMETER

Method Detail

getNodeId

public final Id getNodeId()

Gets the nodeId of this Pastry node.

Specified by:

getNodeId in class NodeHandle

Returns:

the node id.

getEpoch

public int getEpoch()

Gets the epoch or session identifier of this Pastry node.

Returns:

the epoch.

getAddress

public final java.net.InetSocketAddress getAddress()

Returns the IP address and port of the remote node.

Returns:

The InetSocketAddress of the remote node.

toString

public abstract java.lang.String toString()

Returns a String representation of this DistNodeHandle. This method is designed to be called by clients using the node handle, and is provided in order to ensure that the right node handle is being talked to.

Returns:

A String representation of the node handle.

equals

public abstract boolean equals(java.lang.Object obj)

Equivalence relation for nodehandles. They are equal if and only if their corresponding NodeIds are equal.

Specified by:

equals in class NodeHandle

Parameters:

obj - the other nodehandle .

Returns:

true if they are equal, false otherwise.

hashCode

public abstract int hashCode()

Hash codes for node handles. It is the hashcode of their corresponding NodeId's.

Specified by:

hashCode in class NodeHandle

Returns:

a hash code.