Package org.klomp.snark.dht

Class NodeInfo

java.lang.Object

net.i2p.data.SimpleDataStructure

org.klomp.snark.dht.NodeInfo

All Implemented Interfaces:

DataStructure

class NodeInfo
extends SimpleDataStructure

Field Summary

Fields

Modifier and Type	Field	Description
static int	LENGTH

Fields inherited from class net.i2p.data.SimpleDataStructure

_data

Constructor Summary

Constructors

Constructor	Description
NodeInfo(byte[] compactInfo, int offset)	No Destination yet available
NodeInfo(String s)	Create from persistent storage string.
NodeInfo(Destination dest, int port)	With a fake NID used for pings
NodeInfo(NID nID, Destination dest, int port)	Use this if we have the full destination
NodeInfo(NID nID, Hash hash, int port)	No Destination yet available

Method Summary

Modifier and Type	Method	Description
Hash	calculateHash()	Calculate the SHA256 value of this object (useful for a few scenarios)
boolean	equals(Object o)	Warning - this returns true for two different classes with the same size and same data, e.g.
static NID	generateNID(Hash h, int p, RandomSource random)	Generate a secure NID that matches the Hash and port.
Destination	getDestination()
Hash	getHash()
NID	getNID()
int	getPort()
int	hashCode()	We assume the data has enough randomness in it, so use the first 4 bytes for speed.
long	lastSeen()
int	length()	The legal length of the byte array in this data structure
void	setDestination(Destination dest)	This can come in later but the hash must match.
String	toPersistentString()	To persistent storage string.
String	toString()

Methods inherited from class net.i2p.data.SimpleDataStructure

fromBase64, fromByteArray, getData, read, readBytes, setData, toBase64, toByteArray, writeBytes

Methods inherited from class java.lang.Object

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

Field Detail

LENGTH

public static final int LENGTH

See Also:

Constant Field Values

Constructor Detail

NodeInfo

public NodeInfo(Destination dest,
                int port)

With a fake NID used for pings

NodeInfo

public NodeInfo(NID nID,
                Destination dest,
                int port)

Use this if we have the full destination

Throws:

IllegalArgumentException

NodeInfo

public NodeInfo(NID nID,
                Hash hash,
                int port)

No Destination yet available

Throws:

IllegalArgumentException

NodeInfo

public NodeInfo(byte[] compactInfo,
                int offset)

No Destination yet available

Parameters:

compactInfo - 20 byte node ID, 32 byte destHash, 2 byte port

offset - starting at this offset in compactInfo

Throws:

IllegalArgumentException

ArrayIndexOutOfBoundsException

NodeInfo

public NodeInfo(String s)
         throws DataFormatException

Create from persistent storage string. Format: NID:Hash:Destination:port First 3 in base 64; Destination may be empty string

Throws:

IllegalArgumentException

DataFormatException

Method Detail

generateNID

public static NID generateNID(Hash h,
                              int p,
                              RandomSource random)

Generate a secure NID that matches the Hash and port. Rules: First 4 bytes must match Hash. Next 2 bytes must match Hash ^ port. Remaining bytes may be random.

Throws:

IllegalArgumentException

length

public int length()

Description copied from class: SimpleDataStructure

The legal length of the byte array in this data structure

Specified by:

length in class SimpleDataStructure

getNID

public NID getNID()

getDestination

public Destination getDestination()

Returns:

may be null if we don't have it

getHash

public Hash getHash()

calculateHash

public Hash calculateHash()

Description copied from interface: DataStructure

Calculate the SHA256 value of this object (useful for a few scenarios)

Specified by:

calculateHash in interface DataStructure

Overrides:

calculateHash in class SimpleDataStructure

Returns:

the SHA256 hash of the byte array, or null if the data is null

setDestination

public void setDestination(Destination dest)
                    throws IllegalArgumentException

This can come in later but the hash must match.

Throws:

IllegalArgumentException - if hash of dest doesn't match previous hash

getPort

public int getPort()

lastSeen

public long lastSeen()

hashCode

public int hashCode()

Description copied from class: SimpleDataStructure

We assume the data has enough randomness in it, so use the first 4 bytes for speed. If this is not the case, override in the extending class.

Overrides:

hashCode in class SimpleDataStructure

equals

public boolean equals(Object o)

Description copied from class: SimpleDataStructure

Warning - this returns true for two different classes with the same size and same data, e.g. SessionKey and SessionTag, but you wouldn't put them in the same Set, would you?

Overrides:

equals in class SimpleDataStructure

toString

public String toString()

Overrides:

toString in class SimpleDataStructure

toPersistentString

public String toPersistentString()

To persistent storage string. Format: NID:Hash:Destination:port First 3 in base 64; Destination may be empty string