com.datastax.driver.core

Class Host

java.lang.Object

com.datastax.driver.core.Host

public class Host
extends Object

A Cassandra node. This class keeps the information the driver maintain on a given Cassandra node.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Host.StateListener Interface for listeners that are interested in hosts added, up, down and removed events.

Method Summary

Methods

Modifier and Type	Method and Description
InetAddress	getAddress() Returns the node address.
VersionNumber	getCassandraVersion() The Cassandra version the host is running.
String	getDatacenter() Returns the name of the datacenter this host is part of.
com.google.common.util.concurrent.ListenableFuture<?>	getInitialReconnectionAttemptFuture()
String	getRack() Returns the name of the rack this host is part of.
InetSocketAddress	getSocketAddress() Returns the node socket address.
int	hashCode()
boolean	isUp() Returns whether the host is considered up by the driver.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getAddress

public InetAddress getAddress()

Returns the node address.

This is a shortcut for getSocketAddress().getAddress().

Returns:

the node InetAddress.

getSocketAddress

public InetSocketAddress getSocketAddress()

Returns the node socket address.

Returns:

the node InetSocketAddress.

getDatacenter

public String getDatacenter()

Returns the name of the datacenter this host is part of.

The returned datacenter name is the one as known by Cassandra. It is also possible for this information to be unavailable. In that case this method returns null, and the caller should always be aware of this possibility.

Returns:

the Cassandra datacenter name or null if datacenter is unavailable.

getRack

public String getRack()

Returns the name of the rack this host is part of.

The returned rack name is the one as known by Cassandra. It is also possible for this information to be unavailable. In that case this method returns null, and the caller should always aware of this possibility.

Returns:

the Cassandra rack name or null if the rack is unavailable

getCassandraVersion

public VersionNumber getCassandraVersion()

The Cassandra version the host is running.

As for other host information fetch from Cassandra above, the returned version can theoretically be null if the information is unavailable.

Returns:

the Cassandra version the host is running.

isUp

public boolean isUp()

Returns whether the host is considered up by the driver.

Please note that this is only the view of the driver and may not reflect reality. In particular a node can be down but the driver hasn't detected it yet, or it can have been restarted and the driver hasn't detected it yet (in particular, for hosts to which the driver does not connect (because the LoadBalancingPolicy.distance method says so), this information may be durably inaccurate). This information should thus only be considered as best effort and should not be relied upon too strongly.

Returns:

whether the node is considered up.

getInitialReconnectionAttemptFuture

public com.google.common.util.concurrent.ListenableFuture<?> getInitialReconnectionAttemptFuture()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object