com.tangosol.net

Class InetAddressHelper

java.lang.Object

com.oracle.coherence.common.net.InetAddresses

com.tangosol.net.InetAddressHelper

public abstract class InetAddressHelper
extends com.oracle.coherence.common.net.InetAddresses

Helper class that encapsulates common InetAddress functionality.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InetAddressHelper.RoutableFilter The RoutableFilter evaluates to true for any InetAddress which is externally routable.
static class	InetAddressHelper.SubnetMaskFilter SubnetMaskFilter evaluates to true for any address with matches the pattern for the masked bits

Nested classes/interfaces inherited from class com.oracle.coherence.common.net.InetAddresses

com.oracle.coherence.common.net.InetAddresses.IsRoutable, com.oracle.coherence.common.net.InetAddresses.IsSubnetMask

Field Summary

Fields inherited from class com.oracle.coherence.common.net.InetAddresses

ADDR_ANY, NAT_CHECK_TIMEOUT, PreferIPv4Stack, PreferIPv6Addresses

Constructor Summary

Constructors

Constructor and Description
InetAddressHelper()

Method Summary

Modifier and Type	Method and Description
static String[]	getAddressDescriptions(Collection colAddresses) Return an array of strings representing addresses in the specified collection.
static InetAddress	getLocalAddress(Filter filter) Obtain the "best" local host address which matches the supplied filter.
static Collection<InetAddress>	getRoutableAddresses(InetAddress addrLocal, boolean fLocalSrc, Collection<InetAddress> colDest, boolean fLocalDest) Return the set of addresses from the specified destination addresses which appear to be routable from addrLocal.
static boolean	isAnyLocalAddress(InetAddress addr) Deprecated. As of Coherence 3.0, replaced by InetAddress.isAnyLocalAddress()
static boolean	isLinkLocalAddress(InetAddress addr) Deprecated. As of Coherence 3.0, replaced by InetAddress.isLinkLocalAddress()
static boolean	isLoopbackAddress(InetAddress addr) Deprecated. As of Coherence 3.0, replaced by InetAddress.isLoopbackAddress()
static boolean	isSiteLocalAddress(InetAddress addr) Deprecated. As of Coherence 3.0, replaced by InetAddress.isSiteLocalAddress()
static String	toString(byte[] ab) Converts a byte array to a raw IP address string representation.
static String	toString(InetAddress addr) Format an IP address string representing the specified InetAddress object.
static String	toString(int nPort) Format a port string representing the specified port number.
static boolean	virtuallyEqual(byte[] abAddr1, byte[] abAddr2) Compare specified raw IP addresses taking into account IPv4-compatible IPv6 addresses.

Methods inherited from class com.oracle.coherence.common.net.InetAddresses

compare, generateMagic, getAddress, getAllLocalAddresses, getAllLocalMTUs, getByAddress, getLocalAddress, getLocalAddress, getLocalAddresses, getLocalBindableAddresses, getLocalHost, getLocalMTU, getLocalMTU, getLocalMTU, getLocalPeer, getLocalSubnetAddress, getLocalSubnetLength, getPort, getRoutes, getSocketAddress, hasNatLocalAddress, isAnyLocalAddress, isEphemeral, isHostName, isInSubnet, isLocalAddress, isLocalBindableAddress, isLocalReachableAddress, isNatLocalAddress, isNatLocalAddress, isNatLocalAddress, isNatLocalAddress, setAddress, setPort, setSubnetMask, toLong

Methods inherited from class java.lang.Object

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

Constructor Detail

InetAddressHelper

public InetAddressHelper()

Method Detail

getLocalAddress

public static InetAddress getLocalAddress(Filter filter)
                                   throws UnknownHostException

Obtain the "best" local host address which matches the supplied filter.

Parameters:

filter - the filter to match

Returns:

the InetAddress

Throws:

UnknownHostException - if no match can be found

getAddressDescriptions

public static String[] getAddressDescriptions(Collection colAddresses)

Return an array of strings representing addresses in the specified collection.

Parameters:

colAddresses - the collection of addresses

Returns:

an array of strings representing addresses in the specified collection

getRoutableAddresses

public static Collection<InetAddress> getRoutableAddresses(InetAddress addrLocal,
                                                           boolean fLocalSrc,
                                                           Collection<InetAddress> colDest,
                                                           boolean fLocalDest)

Return the set of addresses from the specified destination addresses which appear to be routable from addrLocal. May return null if no routable addresses are found.

If the addrLocal is null, or fLocalSrc is true, then all local addresses are used to compare to the set of destination addresses.

Parameters:

addrLocal - the local address to compare to the destination addresses; may be null

fLocalSrc - whether the source should be considered local to this machine

colDest - the full collection of candidate destination addresses; may contain non-routable local only addresses

fLocalDest - whether the destination is local to this machine

Returns:

the set of addresses from the specified destination addresses which appear to be routable from the source addresses, or null if no addresses are found

Since:

12.2.1

isLoopbackAddress

@Deprecated
public static boolean isLoopbackAddress(InetAddress addr)

Deprecated. As of Coherence 3.0, replaced by InetAddress.isLoopbackAddress()

Check whether or not the specified address is a loopback address.

Parameters:

addr - the InetAddress

Returns:

true iff the address is a loopback address

isAnyLocalAddress

@Deprecated
public static boolean isAnyLocalAddress(InetAddress addr)

Deprecated. As of Coherence 3.0, replaced by InetAddress.isAnyLocalAddress()

Check whether or not the specified address is a wildcard address.

Parameters:

addr - the InetAddress

Returns:

true iff the address is a wildcard address

isLinkLocalAddress

@Deprecated
public static boolean isLinkLocalAddress(InetAddress addr)

Deprecated. As of Coherence 3.0, replaced by InetAddress.isLinkLocalAddress()

Check whether or not the specified address is a link local address.

Parameters:

addr - the InetAddress

Returns:

true iff the address is a link local address

isSiteLocalAddress

@Deprecated
public static boolean isSiteLocalAddress(InetAddress addr)

Deprecated. As of Coherence 3.0, replaced by InetAddress.isSiteLocalAddress()

Check whether or not the specified address is a site local address.

Parameters:

addr - the InetAddress

Returns:

true iff the address is a site local address

virtuallyEqual

public static boolean virtuallyEqual(byte[] abAddr1,
                                     byte[] abAddr2)

Compare specified raw IP addresses taking into account IPv4-compatible IPv6 addresses. Two addresses are considered virtually equal if they have the same protocol (length) and are equal, or if one of them is an IPv6 address that is IPv4-compatible and its IPv4 representation is equal to the other IPv4 address.

Parameters:

abAddr1 - first IP address

abAddr2 - second IP address

Returns:

true iff the addresses are compatible

toString

public static String toString(byte[] ab)

Converts a byte array to a raw IP address string representation. The format of the address string is one of the following:

• "d.d.d.d" for IPv4 address
• "::d.d.d.d" for IPv4 compatible IPv6 address
• "x:x:x:x:x:x:d.d.d.d" for IPv6 mapped IPv4 address

Parameters:

ab - the byte array holding the IP address

Returns:

the IP address string

See Also:

InetAddress.getHostAddress(), Inet6Address

toString

public static String toString(InetAddress addr)

Format an IP address string representing the specified InetAddress object. The main difference if this method over the addr.toString() call is that this implementation avoids a call to the addr.getHostName() method, which could be very expensive due to the reverse DNS lookup.
For IPv6 addresses this method produces an alternative form of "x:x:x:x:x:x:d.d.d.d" and a compressed form of "::d.d.d.d" for IPv4 compatible addresses (instead of the default form "x:x:x:x:x:x:x:x").

Parameters:

addr - the address for which to format the IP address string

Returns:

the IP address string

See Also:

InetAddress.getHostAddress(), Inet6Address

toString

public static String toString(int nPort)

Format a port string representing the specified port number.

If nPort is an extended 32 bit port, then the output will be of the form "port.sub-port"

Parameters:

nPort - the port

Returns:

the port string

Since:

12.2.1

See Also:

InetSocketAddress32