org.apache.hadoop.hbase.util

Class Addressing

java.lang.Object

org.apache.hadoop.hbase.util.Addressing

@InterfaceAudience.Private
public class Addressing
extends Object

Utility for network addresses, resolving and naming.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Addressing.AddressSelectionCondition Interface for AddressSelectionCondition to check if address is acceptable

Field Summary

Fields

Modifier and Type	Field and Description
static String	HOSTNAME_PORT_SEPARATOR
static String	VALID_PORT_REGEX

Constructor Summary

Constructors

Constructor and Description
Addressing()

Method Summary

Modifier and Type	Method and Description
static String	createHostAndPortStr(String hostname, int port) Create a host-and-port string
static InetSocketAddress	createInetSocketAddressFromHostAndPortStr(String hostAndPort) Create a socket address
static InetAddress	getIp4Address()
static InetAddress	getIp6Address()
static InetAddress	getIpAddress()
private static InetAddress	getIpAddress(Addressing.AddressSelectionCondition condition)
static String	inetSocketAddress2String(InetSocketAddress address) Given an InetSocketAddress object returns a String represent of it.
static boolean	isLocalAddress(InetAddress addr) Given an InetAddress, checks to see if the address is a local address, by comparing the address with all the interfaces on the node.
static String	parseHostname(String hostAndPort) Parse the hostname portion of a host-and-port string
static int	parsePort(String hostAndPort) Parse the port portion of a host-and-port string

Methods inherited from class java.lang.Object

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

Field Detail

VALID_PORT_REGEX

public static final String VALID_PORT_REGEX

See Also:

Constant Field Values

HOSTNAME_PORT_SEPARATOR

public static final String HOSTNAME_PORT_SEPARATOR

See Also:

Constant Field Values

Constructor Detail

Addressing

public Addressing()

Method Detail

createInetSocketAddressFromHostAndPortStr

public static InetSocketAddress createInetSocketAddressFromHostAndPortStr(String hostAndPort)

Create a socket address

Parameters:

hostAndPort - Formatted as <hostname> ':' <port>

Returns:

An InetSocketInstance

createHostAndPortStr

public static String createHostAndPortStr(String hostname,
                                          int port)

Create a host-and-port string

Parameters:

hostname - Server hostname

port - Server port

Returns:

Returns a concatenation of hostname and port in following form: <hostname> ':' <port>. For example, if hostname is example.org and port is 1234, this method will return example.org:1234

parseHostname

public static String parseHostname(String hostAndPort)

Parse the hostname portion of a host-and-port string

Parameters:

hostAndPort - Formatted as <hostname> ':' <port>

Returns:

The hostname portion of hostAndPort

parsePort

public static int parsePort(String hostAndPort)

Parse the port portion of a host-and-port string

Parameters:

hostAndPort - Formatted as <hostname> ':' <port>

Returns:

The port portion of hostAndPort

getIpAddress

public static InetAddress getIpAddress()
                                throws SocketException

Throws:

SocketException

getIp4Address

public static InetAddress getIp4Address()
                                 throws SocketException

Throws:

SocketException

getIp6Address

public static InetAddress getIp6Address()
                                 throws SocketException

Throws:

SocketException

getIpAddress

private static InetAddress getIpAddress(Addressing.AddressSelectionCondition condition)
                                 throws SocketException

Throws:

SocketException

isLocalAddress

public static boolean isLocalAddress(InetAddress addr)

Given an InetAddress, checks to see if the address is a local address, by comparing the address with all the interfaces on the node.

Parameters:

addr - address to check if it is local node's address

Returns:

true if the address corresponds to the local node

inetSocketAddress2String

public static String inetSocketAddress2String(InetSocketAddress address)

Given an InetSocketAddress object returns a String represent of it. This is a util method for Java 17. The toString() function of InetSocketAddress will flag the unresolved address with a substring in the string, which will result in unexpected problem. We should use this util function to get the string when we not sure whether the input address is resolved or not.

Parameters:

address - address to convert to a "host:port" String.

Returns:

the String represent of the given address, like "foo:1234".