freenet.io.comm

Class Peer

java.lang.Object

freenet.io.comm.Peer

All Implemented Interfaces:

WritableToDataOutputStream

public class Peer
extends java.lang.Object
implements WritableToDataOutputStream

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Peer.LocalAddressException

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	VERSION

Constructor Summary

Constructors

Constructor and Description
Peer(java.io.DataInput dis)
Peer(java.io.DataInput dis, boolean checkHostnameOrIPSyntax)
Peer(FreenetInetAddress addr, int port)
Peer(java.net.InetAddress address, int port) Create a Peer from an InetAddress and a port.
Peer(java.lang.String physical, boolean allowUnknown) Create a Peer from a string.
Peer(java.lang.String physical, boolean allowUnknown, boolean checkHostnameOrIPSyntax) Create a Peer from a string.

Method Summary

Modifier and Type	Method and Description
Peer	dropHostName()
boolean	equals(java.lang.Object o)
java.net.InetAddress	getAddress() Get the IP address.
java.net.InetAddress	getAddress(boolean doDNSRequest) Get the IP address.
java.net.InetAddress	getAddress(boolean doDNSRequest, boolean allowLocal)
FreenetInetAddress	getFreenetAddress()
java.net.InetAddress	getHandshakeAddress() Get the IP address, looking up the hostname if the hostname is primary, even if it has been looked up before.
int	getPort()
int	hashCode()
boolean	isIPv6(boolean defaultValue) Is this peer using IPv6?
boolean	isNull()
boolean	isRealInternetAddress(boolean lookup, boolean defaultVal, boolean allowLocalAddresses)
boolean	laxEquals(java.lang.Object o)
boolean	strictEquals(java.lang.Object o)
java.lang.String	toString()
java.lang.String	toStringPrefNumeric() Get the address:port string, but prefer numeric IPs - don't return the name.
void	writeToDataOutputStream(java.io.DataOutputStream dos)

Methods inherited from class java.lang.Object

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

Field Detail

VERSION

public static final java.lang.String VERSION

See Also:

Constant Field Values

Constructor Detail

Peer

public Peer(java.io.DataInput dis)
     throws java.io.IOException

Throws:

java.io.IOException

Peer

public Peer(java.io.DataInput dis,
            boolean checkHostnameOrIPSyntax)
     throws HostnameSyntaxException,
            java.io.IOException

Throws:

HostnameSyntaxException

java.io.IOException

Peer

public Peer(java.net.InetAddress address,
            int port)

Create a Peer from an InetAddress and a port. The IP address is primary; that is to say, it will remain the same regardless of DNS changes. Don't do this if you are dealing with domain names whose IP may change.

Peer

public Peer(java.lang.String physical,
            boolean allowUnknown)
     throws PeerParseException,
            java.net.UnknownHostException

Create a Peer from a string. This may be an IP address or a domain name. If it is the latter, the name is primary rather than the IP address; getHandshakeAddress() will do a new lookup on the name, and change the IP address if the domain name has changed.

Parameters:

physical - The string to be parsed, in the format [ ip or domain name ]:[ port number].

allowUnknown - If true, allow construction of the Peer even if the domain name lookup fails.

Throws:

PeerParseException - If the string is not valid e.g. if it doesn't contain a port.

java.net.UnknownHostException - If allowUnknown is not set, and a domain name which does not exist was passed in.

Peer

public Peer(java.lang.String physical,
            boolean allowUnknown,
            boolean checkHostnameOrIPSyntax)
     throws HostnameSyntaxException,
            PeerParseException,
            java.net.UnknownHostException

Create a Peer from a string. This may be an IP address or a domain name. If it is the latter, the name is primary rather than the IP address; getHandshakeAddress() will do a new lookup on the name, and change the IP address if the domain name has changed.

Parameters:

physical - The string to be parsed, in the format [ ip or domain name ]:[ port number].

allowUnknown - If true, allow construction of the Peer even if the domain name lookup fails.

checkHostnameOrIPSyntax - If true, validate the syntax of the given DNS hostname or IPv4 IP address

Throws:

HostnameSyntaxException - If the string is not formatted as a proper DNS hostname or IPv4 IP address

PeerParseException - If the string is not valid e.g. if it doesn't contain a port.

java.net.UnknownHostException - If allowUnknown is not set, and a domain name which does not exist was passed in.

Peer

public Peer(FreenetInetAddress addr,
            int port)

Method Detail

isNull

public boolean isNull()

laxEquals

public boolean laxEquals(java.lang.Object o)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

strictEquals

public boolean strictEquals(java.lang.Object o)

getAddress

public java.net.InetAddress getAddress()

Get the IP address. Look it up if necessary, but return the last value if it has ever been looked up before; will not trigger a new lookup if it has been looked up before.

getAddress

public java.net.InetAddress getAddress(boolean doDNSRequest)

Get the IP address. Look it up if allowed to, but return the last value if it has ever been looked up before; will not trigger a new lookup if it has been looked up before.

getAddress

public java.net.InetAddress getAddress(boolean doDNSRequest,
                                       boolean allowLocal)
                                throws Peer.LocalAddressException

Throws:

Peer.LocalAddressException

getHandshakeAddress

public java.net.InetAddress getHandshakeAddress()

Get the IP address, looking up the hostname if the hostname is primary, even if it has been looked up before. Typically called on a reconnect attempt, when the dyndns address may have changed.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

getPort

public int getPort()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

writeToDataOutputStream

public void writeToDataOutputStream(java.io.DataOutputStream dos)
                             throws java.io.IOException

Specified by:

writeToDataOutputStream in interface WritableToDataOutputStream

Throws:

java.io.IOException

getFreenetAddress

public FreenetInetAddress getFreenetAddress()

isRealInternetAddress

public boolean isRealInternetAddress(boolean lookup,
                                     boolean defaultVal,
                                     boolean allowLocalAddresses)

toStringPrefNumeric

public java.lang.String toStringPrefNumeric()

Get the address:port string, but prefer numeric IPs - don't return the name.

dropHostName

public Peer dropHostName()

isIPv6

public boolean isIPv6(boolean defaultValue)

Is this peer using IPv6?