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

com.datastax.driver.core.exceptions.ReadTimeoutException

All Implemented Interfaces:

CoordinatorException, Serializable

public class ReadTimeoutException
extends QueryConsistencyException

A Cassandra timeout during a read query.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
ReadTimeoutException(ConsistencyLevel consistency, int received, int required, boolean dataPresent)	This constructor should only be used internally by the driver when decoding error responses.
ReadTimeoutException(EndPoint endPoint, ConsistencyLevel consistency, int received, int required, boolean dataPresent)

Method Summary

Modifier and Type	Method	Description
ReadTimeoutException	copy()	Copy the exception.
ReadTimeoutException	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.
boolean	wasDataRetrieved()	Whether the actual data was amongst the received replica responses.

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

getAddress, getConsistencyLevel, getEndPoint, getHost, 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)

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

ReadTimeoutException

public ReadTimeoutException(EndPoint endPoint,
                            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 replicas are only asked for a checksum of the data. A read timeout may have occurred even if enough replicas have responded to fulfill the consistency level, if only checksum responses have been received. This method allows to detect that case.

Returns:

whether the data was amongst the received replica responses.

copy

public ReadTimeoutException 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 ReadTimeoutException 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 address 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.