PeerID (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- org.klomp.snark.PeerID

All Implemented Interfaces:
Comparable<PeerID>
```
public class PeerID
extends Object
implements Comparable<PeerID>
```
Store the address information about a peer. Prior to 0.8.1, an instantiation required a peer ID, and full Destination address. Starting with 0.8.1, to support compact tracker responses, a PeerID can be instantiated with a Destination Hash alone. The full destination lookup is deferred until getAddress() is called, and the PeerID is not required. Equality is now determined solely by the dest hash.

Constructor Summary

Constructors
Constructor and Description
`PeerID(BDecoder be)` Creates a PeerID from a BDecoder.
`PeerID(byte[] id, Destination address)` Creates a PeerID from a peer ID byte array and destination address.
`PeerID(byte[] dest_hash, I2PSnarkUtil util)` Creates a PeerID from a destHash
`PeerID(Map<String,BEValue> m)` Creates a PeerID from a Map containing BEncoded peer id, ip and port.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(PeerID pid)` Compares port, address and id.
`boolean`	`equals(Object o)` Two PeerIDs are equal when they have the same dest hash
`Destination`	`getAddress()` Get the destination.
`byte[]`	`getDestHash()`
`byte[]`	`getID()` Returns the peer ID bytes.
`int`	`getPort()` Returns the port number.
`int`	`hashCode()` The hash code of a PeerID is the hashcode of the desthash
`static String`	`idencode(byte[] bs)` Encode an id as a hex encoded string and remove leading zeros.
`boolean`	`sameID(PeerID pid)` Returns true if and only if this peerID and the given peerID have the same destination hash
`void`	`setID(byte[] xid)` for connecting out to peer based on desthash @since 0.8.1
`String`	`toString()` Returns the String "id@address" where id is the first 4 chars of the base64 encoded id and address is the first 6 chars of the base64 dest (was the base64 hash of the dest) which should match what the bytemonsoon tracker reports on its web pages.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - PeerID
```
public PeerID(BDecoder be)
       throws IOException
```
    Creates a PeerID from a BDecoder.
    Parameters:
    be - the BDecoder to read from
    Throws:
    IOException - if the bencoded data is invalid
  - PeerID
```
public PeerID(byte[] id,
              Destination address)
```
    Creates a PeerID from a peer ID byte array and destination address.
    Parameters:
    id - the peer ID bytes
    address - the destination address
  - PeerID
```
public PeerID(byte[] dest_hash,
              I2PSnarkUtil util)
       throws InvalidBEncodingException
```
    Creates a PeerID from a destHash
    Parameters:
    util - for eventual destination lookup
    Throws:
    InvalidBEncodingException
  - PeerID
```
public PeerID(Map<String,BEValue> m)
       throws InvalidBEncodingException
```
    Creates a PeerID from a Map containing BEncoded peer id, ip and port.
    Parameters:
    m - the map containing peer id and ip entries
    Throws:
    InvalidBEncodingException - if the map entries are missing or invalid
- Method Detail
  - compareTo
```
public int compareTo(PeerID pid)
```
    Compares port, address and id.
    Specified by:
    compareTo in interface Comparable<PeerID>
    Parameters:
    pid - the peer ID to compare to
    Returns:
    a negative, zero, or positive integer
  - equals
```
public boolean equals(Object o)
```
    Two PeerIDs are equal when they have the same dest hash
    Overrides:
    equals in class Object
  - getAddress
```
public Destination getAddress()
```
    Get the destination. If this PeerId was instantiated with a destHash, and we have not yet done so, lookup the full destination, which may take up to 10 seconds.
    Returns:
    Dest or null if unknown
  - getDestHash
```
public byte[] getDestHash()
```
    Returns:
    the dest hash
  - getID
```
public byte[] getID()
```
    Returns the peer ID bytes.
    Returns:
    the peer ID, or null if not yet set
  - getPort
```
public int getPort()
```
    Returns the port number.
    Returns:
    the port
  - hashCode
```
public int hashCode()
```
    The hash code of a PeerID is the hashcode of the desthash
    Overrides:
    hashCode in class Object
  - idencode
```
public static String idencode(byte[] bs)
```
    Encode an id as a hex encoded string and remove leading zeros.
  - sameID
```
public boolean sameID(PeerID pid)
```
    Returns true if and only if this peerID and the given peerID have the same destination hash
  - setID
```
public void setID(byte[] xid)
```
    for connecting out to peer based on desthash @since 0.8.1
  - toString
```
public String toString()
```
    Returns the String "id@address" where id is the first 4 chars of the base64 encoded id and address is the first 6 chars of the base64 dest (was the base64 hash of the dest) which should match what the bytemonsoon tracker reports on its web pages.
    Overrides:
    toString in class Object

Class PeerID

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PeerID

PeerID

PeerID

PeerID

Method Detail

compareTo

equals

getAddress

getDestHash

getID

getPort

hashCode

idencode

sameID

setID

toString