Skip to content
DataStax Java Driver for Apache Cassandra
Java Other
  1. Java 99.8%
  2. Other 0.2%
Branch: 4.x
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
changelog Prepare changelog for next iteration Oct 31, 2019
ci Enable Travis CI builds against OpenJDK 8 and 11 (#1168) Jan 7, 2019
core-shaded Fix minor syntax issue in comment Nov 21, 2019
core Change version to next minor Oct 31, 2019
distribution Change version to next minor Oct 31, 2019
examples Change version to next minor Oct 31, 2019
faq JAVA-2412: Cover DDL query debouncing in FAQ and upgrade guide Sep 27, 2019
integration-tests Change version to next minor Oct 31, 2019
manual Revisit cloud manual page Oct 31, 2019
mapper-processor Change version to next minor Oct 31, 2019
mapper-runtime Change version to next minor Oct 31, 2019
query-builder Change version to next minor Oct 31, 2019
test-infra Change version to next minor Oct 31, 2019
upgrade_guide JAVA-2412: Cover DDL query debouncing in FAQ and upgrade guide Sep 27, 2019
.gitignore Update .gitignore for new documentor file Apr 12, 2018
.travis.yml Force Trusty distribution in Travis build Jul 31, 2019
CONTRIBUTING.md JAVA-2153: Standardize test rule usage in ITs Aug 12, 2019
LICENSE JAVA-1763: Generate a binary tarball as part of the build process Jun 26, 2018
README.md Update version in docs Oct 30, 2019
build.yaml JAVA-2356: Migrate Cloud API to OSS driver Oct 21, 2019
docs.yaml JAVA-1845: Include reference.conf in the manual Jun 1, 2018
install-snapshots.sh Fix install-snapshots.sh to not error out when no snapshots Aug 26, 2019
pom.xml Change version to next minor Oct 31, 2019
pre-commit.sh Remove `git stash` from pre-commit hook Apr 26, 2017

README.md

Datastax Java Driver for Apache Cassandra®

Maven Central

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 DataStax Docs or via the release tags, e.g. 4.3.0.

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

Getting the driver

The driver artifacts are published in Maven central, under the group id com.datastax.oss; there are multiple modules, all prefixed with java-driver-.

<dependency>
  <groupId>com.datastax.oss</groupId>
  <artifactId>java-driver-core</artifactId>
  <version>${driver.version}</version>
</dependency>

<dependency>
  <groupId>com.datastax.oss</groupId>
  <artifactId>java-driver-query-builder</artifactId>
  <version>${driver.version}</version>
</dependency>

<dependency>
  <groupId>com.datastax.oss</groupId>
  <artifactId>java-driver-mapper-runtime</artifactId>
  <version>${driver.version}</version>
</dependency>

Note that the query builder is now published as a separate artifact, you'll need to add the dependency if you plan to use it.

Refer to each module's manual for more details (core, query builder, mapper).

Compatibility

The driver is compatible with Apache Cassandra® 2.1 and higher, and DataStax Enterprise 4.7 and higher.

It requires Java 8 or higher.

If using DataStax Enterprise, the DataStax Enterprise Java driver provides more features and better compatibility.

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

Migrating from previous versions

Java driver 4 is not binary compatible with previous versions. However, most of the concepts remain unchanged, and the new API will look very familiar to 2.x and 3.x users.

See the upgrade guide for details.

Useful links

License

© DataStax, Inc.

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.


DataStax is a registered trademark of DataStax, Inc. and its subsidiaries in the United States and/or other countries.

Apache Cassandra, Apache, Tomcat, Lucene, Solr, Hadoop, Spark, TinkerPop, and Cassandra are trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.

You can’t perform that action at this time.