Google Git
Sign in
apache/cassandra-java-driver/HEAD
commit
be4e00b3a283184883571e094c9feba601eb60d9
[log]
author
absurdfarce <bret.mcguire@ibm.com>
Mon May 11 18:34:28 2026 -0500
committer
Bret McGuire <absurdfarce@users.noreply.github.com>
Fri May 15 11:55:15 2026 -0500
tree
0bcc8cd45d82710bda98296738b72a580c1236cd
parent
c7fe73fe23149c10fe365402b55a6dc88b90b0d4 [diff]
Revert #2051 and replace it with something closer to the intent of the original PR (#1901).

The change that was actually merged attempted to bump us up to the most recent Java8-compatible
logback impl.  This moved us from 1.2.x to 1.3.x which in turn brought some dependency changes
that were excessive, especially for a patch release.

patch by Bret McGuire; reviewed by Andy Tolbert and Abe Ratnofsky
reference: https://github.com/apache/cassandra-java-driver/pull/2088
2 files changed
tree: 0bcc8cd45d82710bda98296738b72a580c1236cd
  1. .github/
  2. bom/
  3. changelog/
  4. ci/
  5. core/
  6. core-shaded/
  7. distribution/
  8. distribution-source/
  9. distribution-tests/
  10. examples/
  11. faq/
  12. guava-shaded/
  13. integration-tests/
  14. licenses/
  15. manual/
  16. mapper-processor/
  17. mapper-runtime/
  18. metrics/
  19. mkdocs/
  20. osgi-tests/
  21. performance/
  22. query-builder/
  23. test-infra/
  24. upgrade_guide/
  25. .asf.yaml
  26. .gitignore
  27. .snyk
  28. build-doc.sh
  29. CONTRIBUTING.md
  30. docs.yaml
  31. install-snapshots.sh
  32. Jenkinsfile-asf
  33. Jenkinsfile-datastax
  34. LICENSE
  35. LICENSE_binary
  36. mkdocs.yml
  37. NOTICE.txt
  38. NOTICE_binary.txt
  39. pom.xml
  40. pre-commit.sh
  41. README.md
README.md

Java Driver for Apache Cassandra®

License 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.17.0.

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

Getting the driver

The driver artifacts are published in Maven central, under the group id org.apache.cassandra; there are multiple modules, all prefixed with java-driver-.

<dependency>
  <groupId>org.apache.cassandra</groupId>
  <artifactId>java-driver-core</artifactId>
  <version>${driver.version}</version>
</dependency>

<dependency>
  <groupId>org.apache.cassandra</groupId>
  <artifactId>java-driver-query-builder</artifactId>
  <version>${driver.version}</version>
</dependency>

<dependency>
  <groupId>org.apache.cassandra</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, DataStax Enterprise 4.7 and higher, and DataStax Astra.

It requires Java 8 or higher.

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

© The Apache Software Foundation

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.

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.

Binary artifacts of this product bundle Java Native Runtime libraries, which is available under the Eclipse Public License version 2.0.