Deprecated API

Contents

• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
com.datastax.driver.core.policies.DowngradingConsistencyRetryPolicy as of version 3.5.0, this retry policy has been deprecated, and it will be removed in 4.0.0. See our upgrade guide to understand how to migrate existing applications that rely on this policy.
com.datastax.driver.core.policies.IdempotenceAwareRetryPolicy As of version 3.1.0, the driver doesn't retry non-idempotent statements for write timeouts or unexpected errors anymore. It is no longer necessary to wrap your retry policies in this policy.
com.datastax.driver.core.JdkSSLOptions Use RemoteEndpointAwareJdkSSLOptions instead.
com.datastax.driver.core.NettySSLOptions Use RemoteEndpointAwareNettySSLOptions instead.

Deprecated Methods

Method and Description
com.datastax.driver.core.policies.DCAwareRoundRobinPolicy.Builder.allowRemoteDCsForLocalConsistencyLevel() This functionality will be removed in the next major release of the driver. DC failover shouldn't be done in the driver, which does not have the necessary context to know what makes sense considering application semantics.
com.datastax.driver.core.querybuilder.BuiltStatement.escapeId(String) preserved for backward compatibility, use Metadata.quoteIfNecessary(String) instead.
com.datastax.driver.core.Host.getAddress() This is exposed mainly for historical reasons. Internally, the driver uses Host.getEndPoint() to establish connections. This is a shortcut for getEndPoint().resolve().getAddress().
com.datastax.driver.core.exceptions.UnsupportedProtocolVersionException.getAddress()
com.datastax.driver.core.exceptions.UnpreparedException.getAddress()
com.datastax.driver.core.exceptions.UnavailableException.getAddress()
com.datastax.driver.core.exceptions.UnauthorizedException.getAddress()
com.datastax.driver.core.exceptions.TruncateException.getAddress()
com.datastax.driver.core.exceptions.SyntaxError.getAddress()
com.datastax.driver.core.exceptions.ServerError.getAddress()
com.datastax.driver.core.exceptions.QueryConsistencyException.getAddress()
com.datastax.driver.core.exceptions.ProtocolError.getAddress()
com.datastax.driver.core.exceptions.OverloadedException.getAddress()
com.datastax.driver.core.exceptions.InvalidQueryException.getAddress()
com.datastax.driver.core.exceptions.FunctionExecutionException.getAddress()
com.datastax.driver.core.exceptions.CoordinatorException.getAddress() CoordinatorException.getEndPoint() provides more accurate information if the connection information consists of more than a socket address. This method is a shortcut for getEndPoint().resolve().
com.datastax.driver.core.exceptions.ConnectionException.getAddress()
com.datastax.driver.core.exceptions.CDCWriteException.getAddress()
com.datastax.driver.core.exceptions.BusyPoolException.getAddress()
com.datastax.driver.core.exceptions.BusyConnectionException.getAddress()
com.datastax.driver.core.exceptions.BootstrappingException.getAddress()
com.datastax.driver.core.exceptions.AuthenticationException.getAddress()
com.datastax.driver.core.exceptions.AlreadyExistsException.getAddress()
com.datastax.driver.core.Host.getDseVersion() Please use the Java driver for DSE if you are connecting to a DataStax Enterprise (DSE) cluster. This method might not function properly with future versions of DSE.
com.datastax.driver.core.Host.getDseWorkload() Please use the Java driver for DSE if you are connecting to a DataStax Enterprise (DSE) cluster. This method might not function properly with future versions of DSE.
com.datastax.driver.core.exceptions.UnsupportedProtocolVersionException.getHost()
com.datastax.driver.core.exceptions.UnpreparedException.getHost()
com.datastax.driver.core.exceptions.UnavailableException.getHost()
com.datastax.driver.core.exceptions.UnauthorizedException.getHost()
com.datastax.driver.core.exceptions.TruncateException.getHost()
com.datastax.driver.core.exceptions.SyntaxError.getHost()
com.datastax.driver.core.exceptions.ServerError.getHost()
com.datastax.driver.core.exceptions.QueryConsistencyException.getHost()
com.datastax.driver.core.exceptions.ProtocolError.getHost()
com.datastax.driver.core.exceptions.OverloadedException.getHost()
com.datastax.driver.core.exceptions.InvalidQueryException.getHost()
com.datastax.driver.core.exceptions.FunctionExecutionException.getHost()
com.datastax.driver.core.exceptions.CoordinatorException.getHost() CoordinatorException.getEndPoint() provides more accurate information if the connection information consists of more than a socket address. This method is a shortcut for getEndPoint().resolve().getAddress().
com.datastax.driver.core.exceptions.ConnectionException.getHost()
com.datastax.driver.core.exceptions.CDCWriteException.getHost()
com.datastax.driver.core.exceptions.BusyPoolException.getHost()
com.datastax.driver.core.exceptions.BusyConnectionException.getHost()
com.datastax.driver.core.exceptions.BootstrappingException.getHost()
com.datastax.driver.core.exceptions.AuthenticationException.getHost()
com.datastax.driver.core.exceptions.AlreadyExistsException.getHost()
com.datastax.driver.core.Host.getSocketAddress() This is exposed mainly for historical reasons. Internally, the driver uses Host.getEndPoint() to establish connections. This is a shortcut for getEndPoint().resolve().
com.datastax.driver.mapping.Mapper.Option.getType() This method is public for backward compatibility only. It should not be accessible since it leaks a package-private type.
com.datastax.driver.core.Host.isDseGraphEnabled() Please use the Java driver for DSE if you are connecting to a DataStax Enterprise (DSE) cluster. This method might not function properly with future versions of DSE.
com.datastax.driver.mapping.Mapper.mapAliased(ResultSet) you no longer need to specify whether a result set is aliased, it will be detected automatically. Use Mapper.map(ResultSet) instead of this method.
com.datastax.driver.core.ExtendedAuthProvider.newAuthenticator(InetSocketAddress, String) the driver will never call this method on ExtendedAuthProvider instances. Implementors should throw AssertionError.
com.datastax.driver.core.SSLOptions.newSSLHandler(SocketChannel) use RemoteEndpointAwareSSLOptions#newSSLHandler(SocketChannel, EndPoint) instead.
com.datastax.driver.core.policies.DCAwareRoundRobinPolicy.Builder.withUsedHostsPerRemoteDc(int) This functionality will be removed in the next major release of the driver. DC failover shouldn't be done in the driver, which does not have the necessary context to know what makes sense considering application semantics.

Deprecated Constructors

Constructor and Description
com.datastax.driver.core.exceptions.ReadFailureException(ConsistencyLevel, int, int, int, boolean) Legacy constructor for backward compatibility.
com.datastax.driver.core.exceptions.ReadFailureException(EndPoint, ConsistencyLevel, int, int, int, boolean) Legacy constructor for backward compatibility.
com.datastax.driver.core.policies.TokenAwarePolicy(LoadBalancingPolicy, boolean) Use TokenAwarePolicy(LoadBalancingPolicy, ReplicaOrdering) instead. This constructor will be removed in the next major release.
com.datastax.driver.core.exceptions.WriteFailureException(ConsistencyLevel, WriteType, int, int, int) Legacy constructor for backward compatibility.
com.datastax.driver.core.exceptions.WriteFailureException(EndPoint, ConsistencyLevel, WriteType, int, int, int) Legacy constructor for backward compatibility.