/**
* Defines whether to retry and at which consistency level on a read timeout.
*
* <p>This method triggers a maximum of one retry, and only if enough replica had responded to the
* read request but data was not retrieved amongst those. Indeed, that case usually means that
* enough replica are alive to satisfy the consistency but the coordinator picked a dead one for
* data retrieval, not having detected that replica as dead yet. The reasoning for retrying then
* is that by the time we get the timeout the dead replica will likely have been detected as dead
* and the retry has a high change of success.
*
* @param query the original query that timeouted.
* @param cl the original consistency level of the read that timeouted.
* @param requiredResponses the number of responses that were required to achieve the requested
* consistency level.
* @param receivedResponses the number of responses that had been received by the time the timeout
* exception was raised.
* @param dataRetrieved whether actual data (by opposition to data checksum) was present in the
* received responses.
* @param nbRetry the number of retry already performed for this operation.
* @return {@code RetryDecision.retry(cl)} if no retry attempt has yet been tried and {@code
* receivedResponses >= requiredResponses && !dataRetrieved}, {@code RetryDecision.rethrow()}
* otherwise.
*/
@Override
public RetryDecision onReadTimeout(
Query query,
ConsistencyLevel cl,
int requiredResponses,
int receivedResponses,
boolean dataRetrieved,
int nbRetry) {
if (nbRetry != 0) return RetryDecision.rethrow();
return receivedResponses >= requiredResponses && !dataRetrieved
? RetryDecision.retry(cl)
: RetryDecision.rethrow();
}
/**
* Defines whether to retry and at which consistency level on a write timeout.
*
* <p>This method triggers a maximum of one retry, and only in the case of a {@code
* WriteType.BATCH_LOG} write. The reasoning for the retry in that case is that write to the
* distributed batch log is tried by the coordinator of the write against a small subset of all
* the node alive in the local datacenter. Hence, a timeout usually means that none of the nodes
* in that subset were alive but the coordinator hasn't detected them as dead. By the time we get
* the timeout the dead nodes will likely have been detected as dead and the retry has thus a high
* change of success.
*
* @param query the original query that timeouted.
* @param cl the original consistency level of the write that timeouted.
* @param writeType the type of the write that timeouted.
* @param requiredAcks the number of acknowledgments that were required to achieve the requested
* consistency level.
* @param receivedAcks the number of acknowledgments that had been received by the time the
* timeout exception was raised.
* @param nbRetry the number of retry already performed for this operation.
* @return {@code RetryDecision.retry(cl)} if no retry attempt has yet been tried and {@code
* writeType == WriteType.BATCH_LOG}, {@code RetryDecision.rethrow()} otherwise.
*/
@Override
public RetryDecision onWriteTimeout(
Query query,
ConsistencyLevel cl,
WriteType writeType,
int requiredAcks,
int receivedAcks,
int nbRetry) {
if (nbRetry != 0) return RetryDecision.rethrow();
// If the batch log write failed, retry the operation as this might just be we were unlucky at
// picking candidtes
return writeType == WriteType.BATCH_LOG ? RetryDecision.retry(cl) : RetryDecision.rethrow();
}
/**
* Defines whether to retry and at which consistency level on an unavailable exception.
*
* <p>This method never retries as a retry on an unavailable exception using the same consistency
* level has almost no change of success.
*
* @param query the original query for which the consistency level cannot be achieved.
* @param cl the original consistency level for the operation.
* @param requiredReplica the number of replica that should have been (known) alive for the
* operation to be attempted.
* @param aliveReplica the number of replica that were know to be alive by the coordinator of the
* operation.
* @param nbRetry the number of retry already performed for this operation.
* @return {@code RetryDecision.rethrow()}.
*/
@Override
public RetryDecision onUnavailable(
Query query, ConsistencyLevel cl, int requiredReplica, int aliveReplica, int nbRetry) {
return RetryDecision.rethrow();
}