com.datastax.oss.driver.api.core.retry

Interface RetryVerdict

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface RetryVerdict

The verdict returned by a RetryPolicy determining what to do when a request failed. A verdict contains a RetryDecision indicating if a retry should be attempted at all and where, and a method that allows the original request to be modified before the retry.

Field Summary

Fields

Modifier and Type	Field and Description
static RetryVerdict	IGNORE A retry verdict that ignores the error, returning and empty result set to the caller.
static RetryVerdict	RETHROW A retry verdict that rethrows the execution error to the calling code.
static RetryVerdict	RETRY_NEXT A retry verdict that retries the same request on the next node in the query plan.
static RetryVerdict	RETRY_SAME A retry verdict that retries the same request on the same node.

Method Summary

Modifier and Type	Method and Description
RetryDecision	getRetryDecision()
default <RequestT extends Request> RequestT	getRetryRequest(RequestT previous) Returns the request to retry, based on the request that was just executed (and failed).

Field Detail

RETRY_SAME

static final RetryVerdict RETRY_SAME

A retry verdict that retries the same request on the same node.

RETRY_NEXT

static final RetryVerdict RETRY_NEXT

A retry verdict that retries the same request on the next node in the query plan.

IGNORE

static final RetryVerdict IGNORE

A retry verdict that ignores the error, returning and empty result set to the caller.

RETHROW

static final RetryVerdict RETHROW

A retry verdict that rethrows the execution error to the calling code.

Method Detail

getRetryDecision

@NonNull
RetryDecision getRetryDecision()

Returns:

The retry decision to apply.

getRetryRequest

@NonNull
default <RequestT extends Request> RequestT getRetryRequest(@NonNull
                                                                     RequestT previous)

Returns the request to retry, based on the request that was just executed (and failed).

The default retry policy always returns the request as is. Custom retry policies can use this method to customize the request to retry, for example, by changing its consistency level, query timestamp, custom payload, or even its execution profile.

Type Parameters:

RequestT - The actual type of the request.

Parameters:

previous - The request that was just executed (and failed).

Returns:

The request to retry.