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