Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
com.datastax.dse.driver.api.core.DseSession All DSE functionality is now available directly on CqlSession. This type is preserved for backward compatibility, but you should now use CqlSession instead.
com.datastax.dse.driver.api.core.graph.GraphExecutionInfo This interface is not used by any driver component anymore; the driver now exposes instances of ExecutionInfo for all Graph queries.

Deprecated Classes

Class and Description
com.datastax.dse.driver.api.core.config.DseDriverConfigLoader This class only exists for backward compatibility. All of its methods delegate to their counterparts on DriverConfigLoader, which you should call directly instead.
com.datastax.dse.driver.api.core.auth.DsePlainTextAuthProviderBase The driver's default plain text providers now support both Apache Cassandra and DSE. This type was preserved for backward compatibility, but implementors should now extend PlainTextAuthProviderBase instead.
com.datastax.dse.driver.api.core.DseSessionBuilder DSE functionality is now exposed directly on CqlSession. This class is preserved for backward compatibility, but CqlSession.builder() should be used instead.

Deprecated Fields

Field and Description
com.datastax.oss.driver.api.core.config.TypedDriverOption.COALESCER_MAX_RUNS This option was removed in version 4.6.1.
com.datastax.dse.driver.api.core.DseSession.DSE_DRIVER_COORDINATES the DSE driver is no longer published as a separate artifact. This field is preserved for backward compatibility, but it returns the same value as Session.OSS_DRIVER_COORDINATES.

Deprecated Methods

Method and Description
com.datastax.oss.driver.api.core.session.SessionBuilder.buildContext(DriverConfigLoader, List<TypeCodec<?>>, NodeStateListener, SchemaChangeListener, RequestTracker, Map<String, String>, Map<String, Predicate<Node>>, ClassLoader) this method only exists for backward compatibility (if a subclass written for driver 4.1.0 returns a non-null result, that value will be used). Please override SessionBuilder.buildContext(DriverConfigLoader, ProgrammaticArguments) instead.
com.datastax.oss.driver.api.core.session.SessionBuilder.defaultConfigLoader()
com.datastax.oss.driver.api.core.cql.StatementBuilder.disableTracing() this method only exists to ease the transition from driver 3, it is an alias for setTracing(false).
com.datastax.oss.driver.api.core.cql.Statement.disableTracing() this method only exists to ease the transition from driver 3, it is an alias for setTracing(false).
com.datastax.oss.driver.api.core.cql.StatementBuilder.enableTracing() this method only exists to ease the transition from driver 3, it is an alias for setTracing(true).
com.datastax.oss.driver.api.core.cql.Statement.enableTracing() this method only exists to ease the transition from driver 3, it is an alias for setTracing(true).
com.datastax.dse.driver.api.core.config.DseDriverConfigLoader.fromClasspath(String) This method only exists for backward compatibility. It delegates to DriverConfigLoader.fromClasspath(String), which you should call directly instead.
com.datastax.oss.driver.api.core.AllNodesFailedException.fromErrors(Map<Node, Throwable>) Use AllNodesFailedException.fromErrors(List) instead.
com.datastax.dse.driver.api.core.config.DseDriverConfigLoader.fromFile(File) This method only exists for backward compatibility. It delegates to DriverConfigLoader.fromFile(File), which you should call directly instead.
com.datastax.dse.driver.api.core.config.DseDriverConfigLoader.fromUrl(URL) This method only exists for backward compatibility. It delegates to DriverConfigLoader.fromUrl(URL), which you should call directly instead.
com.datastax.oss.driver.api.core.auth.PlainTextAuthProviderBase.Credentials.getAuthenticationId() this method only exists for backward compatibility. It is a synonym for PlainTextAuthProviderBase.Credentials.getUsername(), which should be used instead.
com.datastax.oss.driver.api.core.data.GettableById.getBool(CqlIdentifier) this method only exists to ease the transition from driver 3, it is an alias for GettableById.getBoolean(CqlIdentifier).
com.datastax.oss.driver.api.core.data.GettableByIndex.getBool(int) this method only exists to ease the transition from driver 3, it is an alias for GettableByIndex.getBoolean(int).
com.datastax.oss.driver.api.core.data.GettableByName.getBool(String) this method only exists to ease the transition from driver 3, it is an alias for GettableByName.getBoolean(String).
com.datastax.oss.driver.api.core.cql.QueryTrace.getCoordinator() returns the coordinator IP, but QueryTrace.getCoordinatorAddress() should be preferred, since C* 4.0 and above now returns the port was well.
com.datastax.oss.driver.api.core.cql.Statement.getDefaultTimestamp() this method only exists to ease the transition from driver 3, it is an alias for Statement.getQueryTimestamp().
com.datastax.oss.driver.api.core.AllNodesFailedException.getErrors() Use AllNodesFailedException.getAllErrors() instead.
com.datastax.dse.driver.api.core.graph.GraphResultSet.getExecutionInfo() Use GraphResultSet.getRequestExecutionInfo() instead.
com.datastax.dse.driver.api.core.graph.AsyncGraphResultSet.getExecutionInfo() Use AsyncGraphResultSet.getRequestExecutionInfo() instead.
com.datastax.oss.driver.api.core.cql.Statement.getFetchSize() this method only exists to ease the transition from driver 3, it is an alias for Statement.getPageSize().
com.datastax.oss.driver.api.core.cql.TraceEvent.getSource() returns the source IP, but TraceEvent.getSourceAddress() should be preferred, since C* 4.0 and above now returns the port was well.
com.datastax.oss.driver.api.core.cql.ExecutionInfo.getStatement() Use ExecutionInfo.getRequest() instead.
com.datastax.dse.driver.api.core.metadata.schema.DseFunctionMetadata.isDeterministic() Use DseFunctionMetadata.getDeterministic() instead.
com.datastax.dse.driver.api.core.metadata.schema.DseAggregateMetadata.isDeterministic() Use DseAggregateMetadata.getDeterministic() instead.
com.datastax.dse.driver.api.core.metadata.schema.DseFunctionMetadata.isMonotonic() use DseFunctionMetadata.getMonotonicity() instead.
com.datastax.oss.driver.api.core.tracker.RequestTracker.onError(Request, Throwable, long, DriverExecutionProfile, Node) This method only exists for backward compatibility. Override RequestTracker.onError(Request, Throwable, long, DriverExecutionProfile, Node, String) instead.
com.datastax.oss.driver.api.core.retry.RetryPolicy.onErrorResponse(Request, CoordinatorException, int) As of version 4.10, use RetryPolicy.onErrorResponseVerdict(Request, CoordinatorException, int) instead.
com.datastax.oss.driver.api.core.tracker.RequestTracker.onNodeError(Request, Throwable, long, DriverExecutionProfile, Node) This method only exists for backward compatibility. Override RequestTracker.onNodeError(Request, Throwable, long, DriverExecutionProfile, Node, String) instead.
com.datastax.oss.driver.api.core.tracker.RequestTracker.onNodeSuccess(Request, long, DriverExecutionProfile, Node) This method only exists for backward compatibility. Override RequestTracker.onNodeSuccess(Request, long, DriverExecutionProfile, Node, String) instead.
com.datastax.oss.driver.api.core.retry.RetryPolicy.onReadTimeout(Request, ConsistencyLevel, int, int, boolean, int) As of version 4.10, use RetryPolicy.onReadTimeoutVerdict(Request, ConsistencyLevel, int, int, boolean, int) instead.
com.datastax.oss.driver.api.core.retry.RetryPolicy.onRequestAborted(Request, Throwable, int) As of version 4.10, use RetryPolicy.onRequestAbortedVerdict(Request, Throwable, int) instead.
com.datastax.oss.driver.api.core.tracker.RequestTracker.onSuccess(Request, long, DriverExecutionProfile, Node) This method only exists for backward compatibility. Override RequestTracker.onSuccess(Request, long, DriverExecutionProfile, Node, String) instead.
com.datastax.oss.driver.api.core.retry.RetryPolicy.onUnavailable(Request, ConsistencyLevel, int, int, int) As of version 4.10, use RetryPolicy.onUnavailableVerdict(Request, ConsistencyLevel, int, int, int) instead.
com.datastax.oss.driver.api.core.retry.RetryPolicy.onWriteTimeout(Request, ConsistencyLevel, WriteType, int, int, int) As of version 4.10, use RetryPolicy.onWriteTimeoutVerdict(Request, ConsistencyLevel, WriteType, int, int, int) instead.
com.datastax.dse.driver.api.core.config.DseDriverConfigLoader.programmaticBuilder() This method only exists for backward compatibility. It delegates to DriverConfigLoader.programmaticBuilder(), which you should call directly instead.
com.datastax.oss.driver.api.core.data.SettableById.setBool(CqlIdentifier, boolean) this method only exists to ease the transition from driver 3, it is an alias for SettableById.setBoolean(CqlIdentifier, boolean).
com.datastax.oss.driver.api.core.data.SettableByIndex.setBool(int, boolean) this method only exists to ease the transition from driver 3, it is an alias for SettableByIndex.setBoolean(int, boolean).
com.datastax.oss.driver.api.core.data.SettableByName.setBool(String, boolean) this method only exists to ease the transition from driver 3, it is an alias forSettableByName.setBoolean(String, boolean).
com.datastax.oss.driver.api.core.cql.StatementBuilder.setDefaultTimestamp(long) this method only exists to ease the transition from driver 3, it is an alias for StatementBuilder.setQueryTimestamp(long).
com.datastax.oss.driver.api.core.cql.Statement.setDefaultTimestamp(long) this method only exists to ease the transition from driver 3, it is an alias for Statement.setQueryTimestamp(long).
com.datastax.oss.driver.api.core.cql.StatementBuilder.setFetchSize(int) this method only exists to ease the transition from driver 3, it is an alias for StatementBuilder.setPageSize(int).
com.datastax.oss.driver.api.core.cql.Statement.setFetchSize(int) this method only exists to ease the transition from driver 3, it is an alias for Statement.setPageSize(int).
com.datastax.oss.driver.api.core.session.SessionBuilder.withCredentials(String, String) this method only exists to ease the transition from driver 3, it is an alias for SessionBuilder.withAuthCredentials(String, String).
com.datastax.oss.driver.api.core.session.SessionBuilder.withCredentials(String, String, String) this method only exists to ease the transition from driver 3, it is an alias for SessionBuilder.withAuthCredentials(String, String,String).

Deprecated Constructors

Constructor and Description
com.datastax.oss.driver.api.core.AllNodesFailedException(String, ExecutionInfo, Map<Node, Throwable>) Use AllNodesFailedException.AllNodesFailedException(String, ExecutionInfo, Iterable) instead.
com.datastax.oss.driver.api.core.auth.PlainTextAuthProviderBase.PlainTextAuthenticator(PlainTextAuthProviderBase.Credentials) Preserved for backward compatibility, implementors should use the 3-arg constructor PlainTextAuthenticator(Credentials, EndPoint, String) instead.

Deprecated Enum Constants

Enum Constant and Description
com.datastax.oss.driver.api.core.config.DefaultDriverOption.COALESCER_MAX_RUNS This option was removed in version 4.6.1.