com.datastax.oss.driver.api.core

Class UnsupportedProtocolVersionException

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.UnsupportedProtocolVersionException

All Implemented Interfaces:

Serializable

public class UnsupportedProtocolVersionException
extends DriverException

Indicates that we've attempted to connect to a Cassandra node with a protocol version that it cannot handle (e.g., connecting to a C* 2.1 node with protocol version 4).

The only time when this is returned directly to the client (wrapped in a AllNodesFailedException) is at initialization. If it happens later when the driver is already connected, it is just logged an the corresponding node is forced down.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UnsupportedProtocolVersionException(EndPoint endPoint, String message, List<ProtocolVersion> attemptedVersions)

Method Summary

Modifier and Type	Method and Description
DriverException	copy() Copy the exception.
static UnsupportedProtocolVersionException	forNegotiation(EndPoint endPoint, List<ProtocolVersion> attemptedVersions)
static UnsupportedProtocolVersionException	forSingleAttempt(EndPoint endPoint, ProtocolVersion attemptedVersion)
List<ProtocolVersion>	getAttemptedVersions() The versions that were attempted.
EndPoint	getEndPoint() The address of the node that threw the error.

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

UnsupportedProtocolVersionException

public UnsupportedProtocolVersionException(@Nullable
                                           EndPoint endPoint,
                                           @NonNull
                                           String message,
                                           @NonNull
                                           List<ProtocolVersion> attemptedVersions)

Method Detail

forSingleAttempt

@NonNull
public static UnsupportedProtocolVersionException forSingleAttempt(@NonNull
                                                                            EndPoint endPoint,
                                                                            @NonNull
                                                                            ProtocolVersion attemptedVersion)

forNegotiation

@NonNull
public static UnsupportedProtocolVersionException forNegotiation(@NonNull
                                                                          EndPoint endPoint,
                                                                          @NonNull
                                                                          List<ProtocolVersion> attemptedVersions)

getEndPoint

@Nullable
public EndPoint getEndPoint()

The address of the node that threw the error.

getAttemptedVersions

@NonNull
public List<ProtocolVersion> getAttemptedVersions()

The versions that were attempted.

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