com.datastax.driver.core.exceptions

Class UnavailableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.datastax.driver.core.exceptions.DriverException

com.datastax.driver.core.exceptions.QueryExecutionException

com.datastax.driver.core.exceptions.UnavailableException

All Implemented Interfaces:

CoordinatorException, Serializable

public class UnavailableException
extends QueryExecutionException
implements CoordinatorException

Exception thrown when the coordinator knows there is not enough replicas alive to perform a query with the requested consistency level.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UnavailableException(ConsistencyLevel consistency, int required, int alive) This constructor should only be used internally by the driver when decoding error responses.
UnavailableException(EndPoint endPoint, ConsistencyLevel consistency, int required, int alive)

Method Summary

Modifier and Type	Method and Description
UnavailableException	copy() Copy the exception.
UnavailableException	copy(EndPoint endPoint) Create a copy of this exception with a nicer stack trace, and including the coordinator address that caused this exception to be raised.
InetSocketAddress	getAddress() Deprecated.
int	getAliveReplicas() The number of replicas that were known to be alive by the Cassandra coordinator node when it tried to execute the operation.
ConsistencyLevel	getConsistencyLevel() The consistency level of the operation triggering this unavailable exception.
EndPoint	getEndPoint() The connection information of the coordinator host that was contacted.
InetAddress	getHost() Deprecated.
int	getRequiredReplicas() The number of replica acknowledgements/responses required to perform the operation (with its required consistency level).

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UnavailableException

public UnavailableException(ConsistencyLevel consistency,
                            int required,
                            int alive)

This constructor should only be used internally by the driver when decoding error responses.

UnavailableException

public UnavailableException(EndPoint endPoint,
                            ConsistencyLevel consistency,
                            int required,
                            int alive)

Method Detail

getConsistencyLevel

public ConsistencyLevel getConsistencyLevel()

The consistency level of the operation triggering this unavailable exception.

Returns:

the consistency level of the operation triggering this unavailable exception.

getRequiredReplicas

public int getRequiredReplicas()

The number of replica acknowledgements/responses required to perform the operation (with its required consistency level).

Returns:

the number of replica acknowledgements/responses required to perform the operation.

getAliveReplicas

public int getAliveReplicas()

The number of replicas that were known to be alive by the Cassandra coordinator node when it tried to execute the operation.

Returns:

The number of replicas that were known to be alive by the Cassandra coordinator node when it tried to execute the operation.

getEndPoint

public EndPoint getEndPoint()

Description copied from interface: CoordinatorException

The connection information of the coordinator host that was contacted. May be null if the coordinator is not known.

Specified by:

getEndPoint in interface CoordinatorException

getAddress

@Deprecated
public InetSocketAddress getAddress()

Deprecated.

Description copied from interface: CoordinatorException

The full address of the coordinator host that was contacted; may be null if the coordinator is not known.

Specified by:

getAddress in interface CoordinatorException

getHost

@Deprecated
public InetAddress getHost()

Deprecated.

Description copied from interface: CoordinatorException

The coordinator host that was contacted; may be null if the coordinator is not known.

Specified by:

getHost in interface CoordinatorException

copy

public UnavailableException copy()

Description copied from class: DriverException

Copy the exception.

This returns a new exception, equivalent to the original one, except that because a new object is created in the current thread, the top-most element in the stacktrace of the exception will refer to the current thread (this is mainly intended for internal use by the driver). The cause of the copied exception will be the original exception.

Overrides:

copy in class DriverException

Returns:

a copy/clone of this exception.

copy

public UnavailableException copy(EndPoint endPoint)

Create a copy of this exception with a nicer stack trace, and including the coordinator address that caused this exception to be raised.

This method is mainly intended for internal use by the driver and exists mainly because:

1. the original exception was decoded from a response frame and at that time, the coordinator address was not available; and
2. the newly-created exception will refer to the current thread in its stack trace, which generally yields a more user-friendly stack trace that the original one.

Parameters:

endPoint - The full connection information of the host that caused this exception to be thrown.

Returns:

a copy/clone of this exception, but with the given host address instead of the original one.