org.wildfly.common.net

Class Inet

java.lang.Object

org.wildfly.common.net.Inet

public final class Inet
extends java.lang.Object

Utilities relating to Internet protocol (a.k.a. "INET" or "IP") address manipulation.

Author:

David M. Lloyd

Field Summary

Fields

Modifier and Type	Field and Description
static java.net.Inet4Address	INET4_ANY The "any" address for IPv4.
static java.net.Inet4Address	INET4_BROADCAST The broadcast-all address for IPv4.
static java.net.Inet4Address	INET4_LOOPBACK The traditional loopback address for IPv4.
static java.net.Inet6Address	INET6_ANY The "any" address for IPv6.
static java.net.Inet6Address	INET6_LOOPBACK The loopback address for IPv6.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getHostNameIfResolved(java.net.InetAddress inetAddress) Get the host name of the given address, if it is resolved.
static java.net.Inet4Address	getInet4Address(int s1, int s2, int s3, int s4) Get an IPv4 address from four integer segments.
static java.net.Inet6Address	getInet6Address(int s1, int s2, int s3, int s4, int s5, int s6, int s7, int s8) Get an IPv6 address from eight integer segments.
static boolean	isInet6Address(java.lang.String address) Checks whether given String is a valid IPv6 address.
static java.net.Inet6Address	parseInet6Address(java.lang.String address) Parse an IPv6 address into an Inet6Address object.
static byte[]	parseInet6AddressToBytes(java.lang.String address) Converts IPv6 address from textual representation to bytes.
static java.net.Inet6Address	toInet6Address(java.net.InetAddress inetAddress) Get the IPv6 equivalent of the given address.
static java.lang.String	toOptimalString(byte[] addressBytes) Get the optimal string representation of the bytes of an IP address.
static java.lang.String	toOptimalString(java.net.InetAddress inetAddress) Get the optimal string representation of an IP address.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INET4_ANY

public static final java.net.Inet4Address INET4_ANY

The "any" address for IPv4.

INET4_LOOPBACK

public static final java.net.Inet4Address INET4_LOOPBACK

The traditional loopback address for IPv4.

INET4_BROADCAST

public static final java.net.Inet4Address INET4_BROADCAST

The broadcast-all address for IPv4.

INET6_ANY

public static final java.net.Inet6Address INET6_ANY

The "any" address for IPv6.

INET6_LOOPBACK

public static final java.net.Inet6Address INET6_LOOPBACK

The loopback address for IPv6.

Method Detail

toOptimalString

public static java.lang.String toOptimalString(java.net.InetAddress inetAddress)

Get the optimal string representation of an IP address. For IPv6 addresses, this representation will be more compact that the default.

Parameters:

inetAddress - the address (must not be null)

Returns:

the string representation (not null)

toOptimalString

public static java.lang.String toOptimalString(byte[] addressBytes)

Get the optimal string representation of the bytes of an IP address.

Parameters:

addressBytes - the address bytes (must not be null)

Returns:

the string representation (not null)

toInet6Address

public static java.net.Inet6Address toInet6Address(java.net.InetAddress inetAddress)

Get the IPv6 equivalent of the given address. If the address is IPv4 then it is returned as a compatibility address.

Parameters:

inetAddress - the address to convert (must not be null)

Returns:

the converted address (not null)

getHostNameIfResolved

public static java.lang.String getHostNameIfResolved(java.net.InetAddress inetAddress)

Get the host name of the given address, if it is resolved. Otherwise, return null.

Parameters:

inetAddress - the address to check (must not be null)

Returns:

the host name, or null if the address has no host name and is unresolved

getInet4Address

public static java.net.Inet4Address getInet4Address(int s1,
                                                    int s2,
                                                    int s3,
                                                    int s4)

Get an IPv4 address from four integer segments. Each segment must be between 0 and 255.

Parameters:

s1 - the first segment

s2 - the second segment

s3 - the third segment

s4 - the fourth segment

Returns:

the address (not null)

getInet6Address

public static java.net.Inet6Address getInet6Address(int s1,
                                                    int s2,
                                                    int s3,
                                                    int s4,
                                                    int s5,
                                                    int s6,
                                                    int s7,
                                                    int s8)

Get an IPv6 address from eight integer segments. Each segment must be between 0 and 65535 (0xffff).

Parameters:

s1 - the first segment

s2 - the second segment

s3 - the third segment

s4 - the fourth segment

s5 - the fifth segment

s6 - the sixth segment

s7 - the seventh segment

s8 - the eighth segment

Returns:

the address (not null)

isInet6Address

public static boolean isInet6Address(java.lang.String address)

Checks whether given String is a valid IPv6 address.

Parameters:

address - address textual representation

Returns:

true if address is a valid IPv6 address, false otherwise

parseInet6Address

public static java.net.Inet6Address parseInet6Address(java.lang.String address)

Parse an IPv6 address into an Inet6Address object.

Parameters:

address - the address to parse

Returns:

the parsed address, or null if the address is not valid

parseInet6AddressToBytes

public static byte[] parseInet6AddressToBytes(java.lang.String address)

Converts IPv6 address from textual representation to bytes.

If given string doesn't represent valid IPv6 address, the method returns null.

Parameters:

address - address textual representation

Returns:

byte array representing the address, or null if the address is not valid