com.datastax.driver.core.exceptions

Class ReadTimeoutException

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

com.datastax.driver.core.exceptions.ReadTimeoutException

All Implemented Interfaces:

Serializable

public class ReadTimeoutException
extends QueryTimeoutException

A Cassandra timeout during a read query.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ReadTimeoutException(ConsistencyLevel consistency, int received, int required, boolean dataPresent)

Method Summary

Methods

Modifier and Type	Method and Description
DriverException	copy() Copy the exception.
boolean	wasDataRetrieved() Whether the actual data was amongst the received replica responses.

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

getConsistencyLevel, getReceivedAcknowledgements, getRequiredAcknowledgements

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

ReadTimeoutException

public ReadTimeoutException(ConsistencyLevel consistency,
                    int received,
                    int required,
                    boolean dataPresent)

Method Detail

wasDataRetrieved

public boolean wasDataRetrieved()

Whether the actual data was amongst the received replica responses. During reads, Cassandra doesn't request data from every replica to minimize internal network traffic. Instead, some replica are only asked for a checksum of the data. A read timeout may occurred even if enough replica have responded to fulfill the consistency level if only checksum responses have been received. This method allow to detect that case.

Returns:

true if the data was amongst the received replica responses, false otherwise.

copy

public DriverException copy()

Description copied from class: DriverException

Copy the exception.

This return 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 mainly use for internal use by the driver). The cause of the copied exception will be the original exception.

Specified by:

copy in class DriverException

Returns:

a copy/clone of this exception.