Package com.couchbase.client.core.util

Class NetworkAddress

java.lang.Object

com.couchbase.client.core.util.NetworkAddress

@Internal
public class NetworkAddress
extends Object

A convenient wrapper class around network primitives in Java. IMPORTANT: DO NOT USE THIS CLASS IF YOU DO NOT KNOW ABSOLUTELY WHAT YOU ARE DOING. This class has only been brought forward from SDK 2 because we need compatibility for the Sdk2CompatibleMemcachedHashingStrategy. Please refrain from using it, since it has lots of drawbacks, mostly around Reverse DNS resolving. How IPv6 is handled: If a hostname is passed in as input instead of a literal IP address, then the class relies on InetAddress.getAllByName(String) to perform a lookup. By default the JVM prefers IPv4 for this lookup in dual stack environments, unless the system property "java.net.preferIPv6Addresses" is set to true on startup. In this case, IPv6 is preferred and automatically selected. Note that there is one specific case where if IPv6 is preferred in dual stack and you are running Couchbase Server pre 5.1 which does not support IPv6, then you must set the system property "com.couchbase.forceIPv4" to true so that the firstly returned IPv6 address is ignored and we are looking for an IPv4 address to be resolved as well. Obviously, in a single IPv6 stack environment working with older Couchbase Server releases won't work.

Since:

1.4.6

Author:

Michael Nitschinger

Field Summary

Fields

Modifier and Type	Field	Description
static final boolean	ALLOW_REVERSE_DNS	Flag which controls the usage of reverse dns
static final boolean	FORCE_IPV4	Flag which controls if even if ipv6 is present, IPv4 should be preferred.
static final String	FORCE_IPV4_PROPERTY
static final String	REVERSE_DNS_PROPERTY

Method Summary

Modifier and Type	Method	Description
static NetworkAddress	create(String input)	Creates a new NetworkAddress from either a hostname or ip address literal.
boolean	equals(Object o)
int	hashCode()
String	hostname()	Returns the hostname for this network address.
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

REVERSE_DNS_PROPERTY

public static final String REVERSE_DNS_PROPERTY

See Also:

• Constant Field Values

FORCE_IPV4_PROPERTY

public static final String FORCE_IPV4_PROPERTY

See Also:

• Constant Field Values

ALLOW_REVERSE_DNS

public static final boolean ALLOW_REVERSE_DNS

Flag which controls the usage of reverse dns

FORCE_IPV4

public static final boolean FORCE_IPV4

Flag which controls if even if ipv6 is present, IPv4 should be preferred.

Method Details

create

@Internal
public static NetworkAddress create(String input)

Creates a new NetworkAddress from either a hostname or ip address literal.

hostname

@Internal
public String hostname()

Returns the hostname for this network address.

Returns:

the hostname.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object