Module com.aoapps.net.types

Package com.aoapps.net

Class HostAddress

java.lang.Object

com.aoapps.net.HostAddress

All Implemented Interfaces:

DtoFactory<HostAddress>, Internable<HostAddress>, Serializable, Comparable<HostAddress>

public final class HostAddress
extends Object
implements Comparable<HostAddress>, Serializable, DtoFactory<HostAddress>, Internable<HostAddress>

Represents a host's address as either a DomainName or an InetAddress. To not allow the IP address representation, use DomainName instead. No DNS lookups are performed during validation.

Author:

AO Industries, Inc.

See Also:

• Serialized Form

Method Summary

Modifier and Type	Method	Description
int	compareTo(HostAddress other)	Sorts IP addresses before domain names.
boolean	equals(Object obj)
DomainName	getDomainName()
HostAddress	getDto()
InetAddress	getInetAddress()
int	hashCode()
HostAddress	intern()	Interns this host address much in the same fashion as String.intern().
String	toBracketedString()
String	toString()
static ValidationResult	validate(String address)	Validates a host address, must be either a valid domain name or a valid IP address.
static HostAddress	valueOf(DomainName domainName)	If domainName is null, returns null.
static HostAddress	valueOf(InetAddress ip)	If ip is null, returns null.
static HostAddress	valueOf(String address)	When enclosed in brackets "[...]", will be parsed as an IPv6 InetAddress (see toBracketedString()).

Methods inherited from class java.lang.Object

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

Method Details

validate

public static ValidationResult validate(String address)

Validates a host address, must be either a valid domain name or a valid IP address.

When enclosed in brackets "[...]", will be validated as an IPv6 InetAddress (see toBracketedString()).

TODO: Must be non-arpa

valueOf

public static HostAddress valueOf(String address)
                           throws ValidationException

When enclosed in brackets "[...]", will be parsed as an IPv6 InetAddress (see toBracketedString()).

Parameters:

address - when null, returns null

Throws:

ValidationException

valueOf

public static HostAddress valueOf(DomainName domainName)

If domainName is null, returns null.

valueOf

public static HostAddress valueOf(InetAddress ip)

If ip is null, returns null.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(HostAddress other)

Sorts IP addresses before domain names.

Specified by:

compareTo in interface Comparable<HostAddress>

toString

public String toString()

Overrides:

toString in class Object

toBracketedString

public String toBracketedString()

intern

public HostAddress intern()

Interns this host address much in the same fashion as String.intern().

Specified by:

intern in interface Internable<HostAddress>

See Also:

• String.intern()

getDomainName

public DomainName getDomainName()

getInetAddress

public InetAddress getInetAddress()

getDto

public HostAddress getDto()

Specified by:

getDto in interface DtoFactory<HostAddress>