freenet.io.comm

Class FreenetInetAddress

java.lang.Object

freenet.io.comm.FreenetInetAddress

public class FreenetInetAddress
extends java.lang.Object

Long-term InetAddress. If created with an IP address, then the IP address is primary. If created with a name, then the name is primary, and the IP address can change. Most code ripped from Peer. Propagates the IP address on equals() but not the hostname. This does not change hashCode() because it only happens if hostname is set, and in that case, hashCode() is based on the hostname and not on the IP address. So it is safe to put FreenetInetAddress's into hashtables: neither equals() nor getAddress() will change its hashCode. BUT a FreenetInetAddress with IP 1.2.3.4 and no hostname is *NOT* equal to one with the IP address and no name. So if you want to match on only the IP address, you need to either call dropHostname() first (after which neither propagation nor getAddress() will change the hashcode), or just use InetAddress's. FIXME reconsider whether we need this. The lazy lookup is useful but not THAT useful, and we have a regular lookup task now anyway. Over-complex, could lead to odd bugs, although not if used correctly as explained above.

Constructor Summary

Constructors

Constructor and Description
FreenetInetAddress(java.io.DataInput dis) Create from serialized form on a DataInputStream.
FreenetInetAddress(java.io.DataInput dis, boolean checkHostnameOrIPSyntax) Create from serialized form on a DataInputStream.
FreenetInetAddress(java.net.InetAddress address) Create from an InetAddress.
FreenetInetAddress(java.lang.String host, boolean allowUnknown)
FreenetInetAddress(java.lang.String host, boolean allowUnknown, boolean checkHostnameOrIPSyntax)

Method Summary

Modifier and Type	Method and Description
FreenetInetAddress	dropHostname() Get a new FreenetInetAddress with host name removed.
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	getHandshakeAddress() Get the IP address, looking up the hostname if the hostname is primary, even if it has been looked up before.
static java.lang.String	getHostName(java.net.InetAddress primaryIPAddress) Return the hostname or the IP address of the given InetAddress.
int	hashCode()
boolean	hasHostnameNoIP()
boolean	isIPv6(boolean defaultValue)
boolean	isRealInternetAddress(boolean lookup, boolean defaultVal, boolean allowLocalAddresses)
boolean	laxEquals(FreenetInetAddress addr)
boolean	strictEquals(FreenetInetAddress addr)
java.lang.String	toString()
java.lang.String	toStringPrefNumeric()
void	writeToDataOutputStream(java.io.DataOutputStream dos)

Methods inherited from class java.lang.Object

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

Constructor Detail

FreenetInetAddress

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

Create from serialized form on a DataInputStream.

Throws:

java.io.IOException

FreenetInetAddress

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

Create from serialized form on a DataInputStream.

Throws:

HostnameSyntaxException

java.io.IOException

FreenetInetAddress

public FreenetInetAddress(java.net.InetAddress address)

Create from an InetAddress. The IP address is primary i.e. fixed. The hostname either doesn't exist, or is looked up.

FreenetInetAddress

public FreenetInetAddress(java.lang.String host,
                          boolean allowUnknown)
                   throws java.net.UnknownHostException

Throws:

java.net.UnknownHostException

FreenetInetAddress

public FreenetInetAddress(java.lang.String host,
                          boolean allowUnknown,
                          boolean checkHostnameOrIPSyntax)
                   throws HostnameSyntaxException,
                          java.net.UnknownHostException

Throws:

HostnameSyntaxException

java.net.UnknownHostException

Method Detail

laxEquals

public boolean laxEquals(FreenetInetAddress addr)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

strictEquals

public boolean strictEquals(FreenetInetAddress addr)

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 only 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.

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

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toStringPrefNumeric

public java.lang.String toStringPrefNumeric()

writeToDataOutputStream

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

Throws:

java.io.IOException

getHostName

public static java.lang.String getHostName(java.net.InetAddress primaryIPAddress)

Return the hostname or the IP address of the given InetAddress. Does not attempt to do a reverse lookup; if the hostname is known, return it, otherwise return the textual IP address.

isRealInternetAddress

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

dropHostname

public FreenetInetAddress dropHostname()

Get a new FreenetInetAddress with host name removed.

Returns:

a new FreenetInetAddress with host name removed; or null if no known ip address is associated with this object. You may want to do a getAddress(true) before calling this.

hasHostnameNoIP

public boolean hasHostnameNoIP()

isIPv6

public boolean isIPv6(boolean defaultValue)