org.apache.cassandra.locator

Class InetAddressAndPort

java.lang.Object

org.apache.cassandra.locator.InetAddressAndPort

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<InetAddressAndPort>

public final class InetAddressAndPort
extends java.lang.Object
implements java.lang.Comparable<InetAddressAndPort>, java.io.Serializable

A class to replace the usage of InetAddress to identify hosts in the cluster. Opting for a full replacement class so that in the future if we change the nature of the identifier the refactor will be easier in that we don't have to change the type just the methods. Because an IP might contain multiple C* instances the identification must be done using the IP + port. InetSocketAddress is undesirable for a couple of reasons. It's not comparable, it's toString() method doesn't correctly bracket IPv6, it doesn't handle optional default values, and a couple of other minor behaviors that are slightly less troublesome like handling the need to sometimes return a port and sometimes not.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
java.net.InetAddress	address
byte[]	addressBytes
int	port

Method Summary

Modifier and Type	Method and Description
int	compareTo(InetAddressAndPort o)
boolean	equals(java.lang.Object o)
static InetAddressAndPort	getByAddress(byte[] address)
static InetAddressAndPort	getByAddress(java.net.InetAddress address)
static InetAddressAndPort	getByAddressOverrideDefaults(java.net.InetAddress address, byte[] addressBytes, java.lang.Integer port)
static InetAddressAndPort	getByAddressOverrideDefaults(java.net.InetAddress address, java.lang.Integer port)
static InetAddressAndPort	getByName(java.lang.String name)
static InetAddressAndPort	getByNameOverrideDefaults(java.lang.String name, java.lang.Integer port)
java.lang.String	getHostAddress(boolean withPort)
int	hashCode()
static void	initializeDefaultPort(int port)
java.lang.String	toString()
java.lang.String	toString(boolean withPort)

Methods inherited from class java.lang.Object

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

Field Detail

address

public final java.net.InetAddress address

addressBytes

public final byte[] addressBytes

port

public final int port

Method Detail

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(InetAddressAndPort o)

Specified by:

compareTo in interface java.lang.Comparable<InetAddressAndPort>

getHostAddress

public java.lang.String getHostAddress(boolean withPort)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toString

public java.lang.String toString(boolean withPort)

getByName

public static InetAddressAndPort getByName(java.lang.String name)
                                    throws java.net.UnknownHostException

Throws:

java.net.UnknownHostException

getByNameOverrideDefaults

public static InetAddressAndPort getByNameOverrideDefaults(java.lang.String name,
                                                           java.lang.Integer port)
                                                    throws java.net.UnknownHostException

Parameters:

name - Hostname + optional ports string

port - Port to connect on, overridden by values in hostname string, defaults to DatabaseDescriptor default if not specified anywhere.

Returns:

Throws:

java.net.UnknownHostException

getByAddress

public static InetAddressAndPort getByAddress(byte[] address)
                                       throws java.net.UnknownHostException

Throws:

java.net.UnknownHostException

getByAddress

public static InetAddressAndPort getByAddress(java.net.InetAddress address)

getByAddressOverrideDefaults

public static InetAddressAndPort getByAddressOverrideDefaults(java.net.InetAddress address,
                                                              java.lang.Integer port)

getByAddressOverrideDefaults

public static InetAddressAndPort getByAddressOverrideDefaults(java.net.InetAddress address,
                                                              byte[] addressBytes,
                                                              java.lang.Integer port)

initializeDefaultPort

public static void initializeDefaultPort(int port)