com.datastax.driver.core.exceptions

Class QueryConsistencyException

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.QueryConsistencyException

All Implemented Interfaces:

CoordinatorException, Serializable

Direct Known Subclasses:

ReadFailureException, ReadTimeoutException, WriteFailureException, WriteTimeoutException

public abstract class QueryConsistencyException
extends QueryExecutionException
implements CoordinatorException

A failure to reach the required consistency level during the execution of a query.

Such an exception is returned when the query has been tried by Cassandra but cannot be achieved with the requested consistency level because either:

• the coordinator did not receive enough replica responses within the rpc timeout set for Cassandra;
• some replicas replied with an error.

.

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QueryConsistencyException(InetSocketAddress address, String msg, ConsistencyLevel consistency, int received, int required)
protected	QueryConsistencyException(InetSocketAddress address, String msg, Throwable cause, ConsistencyLevel consistency, int received, int required)

Method Summary

Modifier and Type	Method and Description
InetSocketAddress	getAddress() The full address of the coordinator host that caused this exception to be thrown.
ConsistencyLevel	getConsistencyLevel() The consistency level of the operation that failed.
InetAddress	getHost() The coordinator host that caused this exception to be thrown.
int	getReceivedAcknowledgements() The number of replicas that had acknowledged/responded to the operation before it failed.
int	getRequiredAcknowledgements() The minimum number of replica acknowledgements/responses that were required to fulfill the operation.

Methods inherited from class com.datastax.driver.core.exceptions.DriverException

copy

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

QueryConsistencyException

protected QueryConsistencyException(InetSocketAddress address,
                                    String msg,
                                    ConsistencyLevel consistency,
                                    int received,
                                    int required)

QueryConsistencyException

protected QueryConsistencyException(InetSocketAddress address,
                                    String msg,
                                    Throwable cause,
                                    ConsistencyLevel consistency,
                                    int received,
                                    int required)

Method Detail

getConsistencyLevel

public ConsistencyLevel getConsistencyLevel()

The consistency level of the operation that failed.

Returns:

the consistency level of the operation that failed.

getReceivedAcknowledgements

public int getReceivedAcknowledgements()

The number of replicas that had acknowledged/responded to the operation before it failed.

Returns:

the number of replica that had acknowledged/responded the operation before it failed.

getRequiredAcknowledgements

public int getRequiredAcknowledgements()

The minimum number of replica acknowledgements/responses that were required to fulfill the operation.

Returns:

The minimum number of replica acknowledgements/response that were required to fulfill the operation.

getHost

public InetAddress getHost()

The coordinator host that caused this exception to be thrown. Note that this is the query coordinator host, not the host which timed out.

Specified by:

getHost in interface CoordinatorException

Returns:

The coordinator host that caused this exception to be thrown, or null if this exception has been generated driver-side.

getAddress

public InetSocketAddress getAddress()

The full address of the coordinator host that caused this exception to be thrown. Note that this is the query coordinator host, not the host which timed out.

Specified by:

getAddress in interface CoordinatorException

Returns:

the full address of the coordinator host that caused this exception to be thrown, or null if this exception has been generated driver-side.