com.datastax.oss.driver.api.core.servererrors

Class UnavailableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.datastax.oss.driver.api.core.DriverException

com.datastax.oss.driver.api.core.servererrors.CoordinatorException

com.datastax.oss.driver.api.core.servererrors.QueryExecutionException

com.datastax.oss.driver.api.core.servererrors.UnavailableException

All Implemented Interfaces:

Serializable

public class UnavailableException
extends QueryExecutionException

Thrown when the coordinator knows there is not enough replicas alive to perform a query with the requested consistency level.

This exception is processed by RetryPolicy.onUnavailable(Request, ConsistencyLevel, int, int, int), which will decide if it is rethrown directly to the client or if the request should be retried. If all other tried nodes also fail, this exception will appear in the AllNodesFailedException thrown to the client.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UnavailableException(Node coordinator, ConsistencyLevel consistencyLevel, int required, int alive)

Method Summary

Modifier and Type	Method and Description
DriverException	copy() Copy the exception.
int	getAlive() The number of replicas that were known to be alive by the coordinator node when it tried to execute the operation.
ConsistencyLevel	getConsistencyLevel() The consistency level of the operation triggering this exception.
int	getRequired() The number of replica acknowledgements/responses required to perform the operation (with its required consistency level).

Methods inherited from class com.datastax.oss.driver.api.core.servererrors.CoordinatorException

getCoordinator

Methods inherited from class com.datastax.oss.driver.api.core.DriverException

getExecutionInfo, setExecutionInfo

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UnavailableException

public UnavailableException(@NonNull
                            Node coordinator,
                            @NonNull
                            ConsistencyLevel consistencyLevel,
                            int required,
                            int alive)

Method Detail

getConsistencyLevel

@NonNull
public ConsistencyLevel getConsistencyLevel()

The consistency level of the operation triggering this exception.

getRequired

public int getRequired()

The number of replica acknowledgements/responses required to perform the operation (with its required consistency level).

getAlive

public int getAlive()

The number of replicas that were known to be alive by the coordinator node when it tried to execute the operation.

copy

@NonNull
public DriverException copy()

Description copied from class: DriverException

Copy the exception.

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. The original exception may or may not be included as the copy's cause, depending on whether that is deemed useful (this is left to the discretion of each implementation).

This is intended for the synchronous wrapper methods of the driver, in order to produce a more user-friendly stack trace (that includes the line in the user code where the driver rethrew the error).

Specified by:

copy in class DriverException