com.datastax.driver.core.policies

Class RetryPolicy.RetryDecision

java.lang.Object

com.datastax.driver.core.policies.RetryPolicy.RetryDecision

Enclosing interface:

RetryPolicy

public static class RetryPolicy.RetryDecision
extends Object

A retry decision to adopt on a Cassandra exception (read/write timeout or unavailable exception).

There are three possible decisions:

• RETHROW: no retry should be attempted and an exception should be thrown.
• RETRY: the operation will be retried. The consistency level of the retry should be specified.
• IGNORE: no retry should be attempted and the exception should be ignored. In that case, the operation that triggered the Cassandra exception will return an empty result set.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RetryPolicy.RetryDecision.Type The types of retry decisions.

Method Summary

Modifier and Type	Method and Description
ConsistencyLevel	getRetryConsistencyLevel() The consistency level for this retry decision.
RetryPolicy.RetryDecision.Type	getType() The type of this retry decision.
static RetryPolicy.RetryDecision	ignore() Creates an RetryPolicy.RetryDecision.Type.IGNORE retry decision.
boolean	isRetryCurrent() Whether this decision is to retry the same host.
static RetryPolicy.RetryDecision	rethrow() Creates a RetryPolicy.RetryDecision.Type.RETHROW retry decision.
static RetryPolicy.RetryDecision	retry(ConsistencyLevel consistency) Creates a RetryPolicy.RetryDecision.Type.RETRY retry decision using the same host and the provided consistency level.
String	toString()
static RetryPolicy.RetryDecision	tryNextHost(ConsistencyLevel retryCL) Creates a RetryPolicy.RetryDecision.Type.RETRY retry decision using the next host in the query plan, and using the provided consistency level.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getType

public RetryPolicy.RetryDecision.Type getType()

The type of this retry decision.

Returns:

the type of this retry decision.

getRetryConsistencyLevel

public ConsistencyLevel getRetryConsistencyLevel()

The consistency level for this retry decision. This is only meaningful for RETRY decisions. The consistency level is always null for an IGNORE or a RETHROW decision; for a RETRY decision, the consistency level can be null, in which case the retry is done at the same consistency level as in the original attempt.

Returns:

the consistency level for a retry decision.

isRetryCurrent

public boolean isRetryCurrent()

Whether this decision is to retry the same host. This is only meaningful for RETRY decisions.

Returns:

true if the decision is to retry the same host, false otherwise. Default is false.

rethrow

public static RetryPolicy.RetryDecision rethrow()

Creates a RetryPolicy.RetryDecision.Type.RETHROW retry decision.

Returns:

a RetryPolicy.RetryDecision.Type.RETHROW retry decision.

retry

public static RetryPolicy.RetryDecision retry(ConsistencyLevel consistency)

Creates a RetryPolicy.RetryDecision.Type.RETRY retry decision using the same host and the provided consistency level.

Parameters:

consistency - the consistency level to use for the retry.

Returns:

a RetryPolicy.RetryDecision.Type.RETRY decision using the same host and the provided consistency level

ignore

public static RetryPolicy.RetryDecision ignore()

Creates an RetryPolicy.RetryDecision.Type.IGNORE retry decision.

Returns:

an RetryPolicy.RetryDecision.Type.IGNORE retry decision.

tryNextHost

public static RetryPolicy.RetryDecision tryNextHost(ConsistencyLevel retryCL)

Creates a RetryPolicy.RetryDecision.Type.RETRY retry decision using the next host in the query plan, and using the provided consistency level.

Returns:

a RetryPolicy.RetryDecision.Type.RETRY retry decision using the next host in the query plan, and using the provided consistency level.

toString

public String toString()

Overrides:

toString in class Object