Rice Pastry API

rice.p2p.glacier
Class VersionKey

java.lang.Object
  extended by rice.p2p.glacier.VersionKey
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable, Id

public class VersionKey
extends java.lang.Object
implements Id, java.io.Serializable, java.lang.Comparable

DESCRIBE THE CLASS

Version:
$Id: VersionKey.java 3524 2007-01-09 14:09:27Z jeffh $
Author:
ahae
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from interface rice.p2p.commonapi.Id
Id.Distance
 
Field Summary
protected  Id id
          DESCRIBE THE FIELD
static short TYPE
           
protected  long version
          DESCRIBE THE FIELD
 
Constructor Summary
VersionKey(Id id, long version)
          Constructor for VersionKey.
VersionKey(InputBuffer buf, Endpoint endpoint)
           
 
Method Summary
 Id addToId(Id.Distance offset)
          Returns an Id corresponding to this Id plus a given distance
static VersionKey build(java.lang.String s)
           
 boolean clockwise(Id nid)
          Checks to see if the Id nid is clockwise or counterclockwise from this, on the ring.
 int compareTo(java.lang.Object o)
          DESCRIBE THE METHOD
 Id.Distance distanceFromId(Id nid)
          Returns the shorter numerical distance on the ring between a pair of Ids.
 boolean equals(java.lang.Object peer)
          DESCRIBE THE METHOD
 int getByteArrayLength()
          Returns the length of the byte[] representing this Id
 Id getId()
          Gets the Id attribute of the VersionKey object
 short getType()
           
 long getVersion()
          Gets the Version attribute of the VersionKey object
 int hashCode()
          DESCRIBE THE METHOD
 boolean isBetween(Id ccw, Id cw)
          Checks if this Id is between two given ids ccw (inclusive) and cw (exclusive) on the circle
 Id.Distance longDistanceFromId(Id nid)
          Returns the longer numerical distance on the ring between a pair of Ids.
 void serialize(OutputBuffer buf)
          Serialize
 byte[] toByteArray()
          DESCRIBE THE METHOD
 void toByteArray(byte[] result, int offset)
          Stores the byte[] value of this Id in the provided byte array
 java.lang.String toString()
          DESCRIBE THE METHOD
 java.lang.String toStringFull()
          DESCRIBE THE METHOD
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

TYPE

public static final short TYPE
See Also:
Constant Field Values

id

protected Id id
DESCRIBE THE FIELD


version

protected long version
DESCRIBE THE FIELD

Constructor Detail

VersionKey

public VersionKey(Id id,
                  long version)
Constructor for VersionKey.

Parameters:
id - DESCRIBE THE PARAMETER
version - DESCRIBE THE PARAMETER

VersionKey

public VersionKey(InputBuffer buf,
                  Endpoint endpoint)
           throws java.io.IOException
Throws:
java.io.IOException
Method Detail

getVersion

public long getVersion()
Gets the Version attribute of the VersionKey object

Returns:
The Version value

getId

public Id getId()
Gets the Id attribute of the VersionKey object

Returns:
The Id value

equals

public boolean equals(java.lang.Object peer)
DESCRIBE THE METHOD

Overrides:
equals in class java.lang.Object
Parameters:
peer - DESCRIBE THE PARAMETER
Returns:
DESCRIBE THE RETURN VALUE

toString

public java.lang.String toString()
DESCRIBE THE METHOD

Overrides:
toString in class java.lang.Object
Returns:
DESCRIBE THE RETURN VALUE

toStringFull

public java.lang.String toStringFull()
DESCRIBE THE METHOD

Specified by:
toStringFull in interface Id
Returns:
DESCRIBE THE RETURN VALUE

compareTo

public int compareTo(java.lang.Object o)
DESCRIBE THE METHOD

Specified by:
compareTo in interface java.lang.Comparable
Parameters:
o - DESCRIBE THE PARAMETER
Returns:
DESCRIBE THE RETURN VALUE

hashCode

public int hashCode()
DESCRIBE THE METHOD

Overrides:
hashCode in class java.lang.Object
Returns:
DESCRIBE THE RETURN VALUE

toByteArray

public byte[] toByteArray()
DESCRIBE THE METHOD

Specified by:
toByteArray in interface Id
Returns:
DESCRIBE THE RETURN VALUE

toByteArray

public void toByteArray(byte[] result,
                        int offset)
Stores the byte[] value of this Id in the provided byte array

Specified by:
toByteArray in interface Id

getByteArrayLength

public int getByteArrayLength()
Returns the length of the byte[] representing this Id

Specified by:
getByteArrayLength in interface Id
Returns:
The length of the byte[] representing this Id

isBetween

public boolean isBetween(Id ccw,
                         Id cw)
Description copied from interface: Id
Checks if this Id is between two given ids ccw (inclusive) and cw (exclusive) on the circle

Specified by:
isBetween in interface Id
Parameters:
ccw - the counterclockwise id
cw - the clockwise id
Returns:
true if this is between ccw (inclusive) and cw (exclusive), false otherwise

longDistanceFromId

public Id.Distance longDistanceFromId(Id nid)
Description copied from interface: Id
Returns the longer numerical distance on the ring between a pair of Ids.

Specified by:
longDistanceFromId in interface Id
Parameters:
nid - the other node id.
Returns:
the distance between this and nid.

distanceFromId

public Id.Distance distanceFromId(Id nid)
Description copied from interface: Id
Returns the shorter numerical distance on the ring between a pair of Ids.

Specified by:
distanceFromId in interface Id
Parameters:
nid - the other node id.
Returns:
the distance between this and nid.

addToId

public Id addToId(Id.Distance offset)
Description copied from interface: Id
Returns an Id corresponding to this Id plus a given distance

Specified by:
addToId in interface Id
Parameters:
offset - the distance to add
Returns:
the new Id

clockwise

public boolean clockwise(Id nid)
Description copied from interface: Id
Checks to see if the Id nid is clockwise or counterclockwise from this, on the ring. An Id is clockwise if it is within the half circle clockwise from this on the ring. An Id is considered counter-clockwise from itself.

Specified by:
clockwise in interface Id
Parameters:
nid - The id to compare to
Returns:
true if clockwise, false otherwise.

build

public static VersionKey build(java.lang.String s)

serialize

public void serialize(OutputBuffer buf)
               throws java.io.IOException
Description copied from interface: Id
Serialize

Specified by:
serialize in interface Id
Throws:
java.io.IOException

getType

public short getType()
Specified by:
getType in interface Id

Rice Pastry API

Copyright © 2001-2005 - Rice Pastry.


Imprint-Dataprotection