DataStax Java Driver for Apache Cassandra
Java Other
Permalink
Failed to load latest commit information.
changelog Update version in docs for 3.1.0. Jul 27, 2016
ci Remove cassandra_version from appveyor.yml Sep 22, 2016
driver-core [maven-release-plugin] prepare for next development iteration Jul 27, 2016
driver-dist [maven-release-plugin] prepare for next development iteration Jul 27, 2016
driver-examples [maven-release-plugin] prepare for next development iteration Jul 27, 2016
driver-extras [maven-release-plugin] prepare for next development iteration Jul 27, 2016
driver-mapping [maven-release-plugin] prepare for next development iteration Jul 27, 2016
driver-tests [maven-release-plugin] prepare for next development iteration Jul 27, 2016
faq Update links in the docs for new 3.x branch Sep 15, 2016
manual Update links in the docs for new 3.x branch Sep 15, 2016
src/license Prevent build from failing when current year does not match license h… Jan 3, 2016
testing Merge pull request #77 from joaquincasares/new_test_groups May 7, 2013
upgrade_guide JAVA-1212: Don't retry non-idempotent statements by default Jul 18, 2016
.gitignore Add jEnv settings file to .gitignore. Aug 4, 2015
.travis.yml Add Slack notifications for Travis May 9, 2016
CONTRIBUTING.md Update contribution guidelines to explain branches Sep 14, 2016
LICENSE Add license file Nov 19, 2012
README.md Update links in the docs for new 3.x branch Sep 15, 2016
build.yaml Use cassandra 3.7 in ci builds. Jul 19, 2016
clirr-ignores.xml JAVA-541 + JAVA-636 + JAVA-984: Polymorphism support to object mapper ( Jul 22, 2016
docs.yaml Update docs to reference 3.0.4. Sep 28, 2016
doxyfile Added doxyfile_java to generate documentation Sep 29, 2015
pom.xml [maven-release-plugin] prepare for next development iteration Jul 27, 2016

README.md

Datastax Java Driver for Apache Cassandra

Build Status

If you're reading this on github.com, please note that this is the readme for the development version and that some features described here might not yet have been released. You can find the documentation for latest version through Java driver docs or via the release tags, e.g. 3.1.0.

A modern, feature-rich and highly tunable Java client library for Apache Cassandra (1.2+) and DataStax Enterprise (3.1+) using exclusively Cassandra's binary protocol and Cassandra Query Language v3.

Features:

The driver architecture is based on layers. At the bottom lies the driver core. This core handles everything related to the connections to a Cassandra 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.

Useful links:

Feeback requested: help us focus our efforts, provide your input on the Platform and Runtime Survey (we kept it short).

Getting the driver

The last release of the driver is available on Maven Central. You can install it in your application using the following Maven dependency:

<dependency>
  <groupId>com.datastax.cassandra</groupId>
  <artifactId>cassandra-driver-core</artifactId>
  <version>3.1.0</version>
</dependency>

Note that the object mapper is published as a separate artifact:

<dependency>
  <groupId>com.datastax.cassandra</groupId>
  <artifactId>cassandra-driver-mapping</artifactId>
  <version>3.1.0</version>
</dependency>

The 'extras' module is also published as a separate artifact:

<dependency>
  <groupId>com.datastax.cassandra</groupId>
  <artifactId>cassandra-driver-extras</artifactId>
  <version>3.1.0</version>
</dependency>

We also provide a shaded JAR to avoid the explicit dependency to Netty.

If you can't use a dependency management tool, a binary tarball is available for download.

Compatibility

The Java client driver 3.1.0 (branch 3.x) is compatible with Apache Cassandra 1.2, 2.0, 2.1, 2.2 and 3.0 (see this page for the most up-to-date compatibility information).

UDT and tuple support is available only when using Apache Cassandra 2.1 or higher (see CQL improvements in Cassandra 2.1).

Other features are available only when using Apache Cassandra 2.0 or higher (e.g. result set paging, BatchStatement, lightweight transactions -- see What's new in Cassandra 2.0). Trying to use these with a cluster running Cassandra 1.2 will result in an UnsupportedFeatureException being thrown.

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.

Troubleshooting

If you are having issues connecting to the cluster (seeing NoHostAvailableConnection exceptions) please check the connection requirements.

License

Copyright 2012-2015, DataStax

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.