public class ReadFailureException extends QueryConsistencyException
This happens when some of the replicas that were contacted by the coordinator replied with an error.
Constructor and Description |
---|
ReadFailureException(ConsistencyLevel consistency,
int received,
int required,
int failed,
boolean dataPresent)
Deprecated.
Legacy constructor for backward compatibility.
|
ReadFailureException(ConsistencyLevel consistency,
int received,
int required,
int failed,
Map<InetAddress,Integer> failuresMap,
boolean dataPresent)
This constructor should only be used internally by the driver when decoding error responses.
|
ReadFailureException(EndPoint endPoint,
ConsistencyLevel consistency,
int received,
int required,
int failed,
boolean dataPresent)
Deprecated.
Legacy constructor for backward compatibility.
|
ReadFailureException(EndPoint endPoint,
ConsistencyLevel consistency,
int received,
int required,
int failed,
Map<InetAddress,Integer> failuresMap,
boolean dataPresent) |
Modifier and Type | Method and Description |
---|---|
ReadFailureException |
copy()
Copy the exception.
|
ReadFailureException |
copy(EndPoint endPoint) |
int |
getFailures()
Returns the number of replicas that experienced a failure while executing the request.
|
Map<InetAddress,Integer> |
getFailuresMap()
Returns the a failure reason code for each node that failed.
|
boolean |
wasDataRetrieved()
Whether the actual data was amongst the received replica responses.
|
getAddress, getConsistencyLevel, getEndPoint, getHost, getReceivedAcknowledgements, getRequiredAcknowledgements
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
public ReadFailureException(ConsistencyLevel consistency, int received, int required, int failed, Map<InetAddress,Integer> failuresMap, boolean dataPresent)
@Deprecated public ReadFailureException(ConsistencyLevel consistency, int received, int required, int failed, boolean dataPresent)
public ReadFailureException(EndPoint endPoint, ConsistencyLevel consistency, int received, int required, int failed, Map<InetAddress,Integer> failuresMap, boolean dataPresent)
@Deprecated public ReadFailureException(EndPoint endPoint, ConsistencyLevel consistency, int received, int required, int failed, boolean dataPresent)
public int getFailures()
public Map<InetAddress,Integer> getFailuresMap()
At the time of writing, the existing reason codes are:
0x0000
: the error does not have a specific code assigned yet, or the cause is
unknown.
0x0001
: The read operation scanned too many tombstones (as defined by tombstone_failure_threshold
in cassandra.yaml
, causing a TombstoneOverwhelmingException
.
This feature is available for protocol v5 or above only. With lower protocol versions, the map will always be empty.
public boolean wasDataRetrieved()
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 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.
public ReadFailureException copy()
DriverException
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.
copy
in class DriverException
public ReadFailureException copy(EndPoint endPoint)
Copyright © 2012–2023. All rights reserved.