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 consistency) 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 previous 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.

If the provided consistency level is null, the retry will be done at the same consistency level as the previous attempt.

Beware that serial consistency levels should never be passed to this method; attempting to do so would trigger an InvalidQueryException.

Parameters:

consistency - the consistency level to use for the retry; if null, the same level as the previous attempt will be used.

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 consistency)

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

If the provided consistency level is null, the retry will be done at the same consistency level as the previous attempt.

Beware that serial consistency levels should never be passed to this method; attempting to do so would trigger an InvalidQueryException.

Parameters:

consistency - the consistency level to use for the retry; if null, the same level as the previous attempt will be used.

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