commit | 0371de6e278a9895c8950decdac5ddfc83bbedd5 | [log] [tgz] |
---|---|---|
author | Henry Hughes <henry.hughes@datastax.com> | Thu Nov 16 23:15:10 2023 -0800 |
committer | mck <mck@apache.org> | Tue Nov 28 20:33:20 2023 +0100 |
tree | 78fcb2575b14c4054f1708a20605568344b74a43 | |
parent | 38b5c650750ef187c579964470903cc769c872c5 [diff] |
Add LICENSE and NOTICE.txt/NOTICE_binary to published jars LICENSE + NOTICE.txt is added to source jars, LICENSE + NOTICE_binary.txt is added to regular jars. Make parent project inherit from apache pom. Updated NOTICE wording to "developed at ..." per latest instructions. patch by Henry Hughes; reviewed by Mick Semb Wever for CASSANDRA-18969
Note: the 2.2 branch has been retired (see this announcement). You are encouraged to move to 3.0.
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. 2.2.0-rc3.
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:
Community:
Feeback requested: help us focus our efforts, provide your input on the Platform and Runtime Survey (we kept it short).
See the changelog for full details.
This version is not binary compatible with the 2.1 branch. Refer to the upgrade guide for more information.
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>2.2.0-rc3</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>2.2.0-rc3</version> </dependency>
We also provide a shaded JAR to avoid the explicit dependency to Netty.
The Java client driver 2.2 (branch 2.2) is compatible with Apache Cassandra 1.2, 2.0, 2.1 and 2.2.
UDT and tuple support is available only when using Apache Cassandra 2.1 (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.
If you are upgrading from a previous version of the driver, be sure to have a look at the upgrade guide.
If you are having issues connecting to the cluster (seeing NoHostAvailableConnection
exceptions) please check the connection requirements.
© 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.