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 Details
- LENGTH
  
  public static final int LENGTH
  
  See Also:
  
  Constant Field Values
Constructor Details
- 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 Details
- 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

Class NodeInfo

Field Summary

Fields inherited from class net.i2p.data.SimpleDataStructure

Constructor Summary

Method Summary

Methods inherited from class net.i2p.data.SimpleDataStructure

Methods inherited from class java.lang.Object

Field Details

Constructor Details

Method Details