DataStax Enterprise Java driver

A modern, feature-rich and highly tunable Java client library for DataStax Enterprise, built on top of the robust, efficient and highly configurable DataStax Java driver for Apache Cassandra®. The DataStax Enterprise Java driver is open source and can only be used with DataStax Enterprise as per its license.

Features:

• Sync and Async API
• Simple, Prepared, and Batch statements
• Asynchronous IO, parallel execution, request pipelining
• Connection pooling
• Auto node discovery
• Automatic reconnection
• Configurable load balancing and retry policies
• Works with any cluster size
• Query builder
• Object mapper
• Authenticator implementations that use the authentication scheme negotiation in the server-side DseAuthenticator;
• value classes for geospatial types, and type codecs that integrate them seamlessly with the driver;
• DSE graph integration.

The driver architecture is based on layers. At the bottom lies the driver core. This core handles everything related to the connections to a DataStax Enterprise cluster (for example, connection pool, discovering new nodes, etc.) and exposes a simple, relatively low-level API on top of which higher level layers can be built.

The driver contains the following modules:

• driver-core: the core layer.
• driver-mapping: the object mapper.
• driver-extras: optional features for the Java driver.
• driver-examples: example applications using the other modules which are only meant for demonstration purposes.
• driver-tests: tests for the java-driver.
• driver-graph: the DSE graph and Tinkerpop compatibility module.

Useful links:

• JIRA (bug tracking): https://datastax-oss.atlassian.net/browse/JAVA
• MAILING LIST: https://groups.google.com/a/lists.datastax.com/forum/#!forum/java-driver-user
• DATASTAX ACADEMY SLACK: #datastax-drivers on https://academy.datastax.com/slack
• TWITTER: @dsJavaDriver tweets Java driver releases and important announcements (low frequency). @DataStaxEng has more news including other drivers, Cassandra, and DSE.
• DOCS: the manual has quick start material and technical details about the driver and its features.
• API: http://docs.datastax.com/en/drivers/java-dse/1.8/
• changelog
• binary tarball

Getting the driver

The driver is available from Maven central:

<dependency>
  <groupId>com.datastax.dse</groupId>
  <artifactId>dse-java-driver-core</artifactId>
  <version>1.8.2</version>
</dependency>

Compatibility

The DataStax Enterprise Java driver is currently tested and supported against DataStax Enterprise 4.8+.

The DSE Graph module is only usable against DSE 5.0+.

The DataStax Enterprise Java driver supports Java JDK versions 6 and above.

Disclaimer: Some DataStax/DataStax Enterprise products might partially work on big-endian systems, but DataStax does not officially support these systems.

Upgrading from previous versions

If you are upgrading from a previous version of the driver, be sure to have a look at the upgrade guide.

The DSE Java Driver is a drop-in replacement of the Java driver for Apache Cassandra and does not require a large adaptation effort to upgrade from the Java driver for Apache Cassandra. For more information see the FAQ.

License

Copyright DataStax, Inc.

The full license terms are available at http://www.datastax.com/terms/datastax-dse-driver-license-terms