Cassandra-Java-Driver-Research

Cassandra-Java-Driver源代码学习研究(包括代码注释、文档、用于代码分析的测试用例)

<<<<<<< HEAD

使用的Cassandra-Java-Driver版本

保持与官方的trunk版本同步

======= 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.1.7.

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:

• 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

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.

b4d397c33abec1f42fa8a35869e219ef60c0e7e8

构建与运行环境

需要JDK7以及Apache Maven

<<<<<<< HEAD

<<<<<<< HEAD

安装

=======

a61ec453c0fd19083590568baf7f345bec5c709e Community:

• JIRA: https://datastax-oss.atlassian.net/browse/JAVA
• MAILING LIST: https://groups.google.com/a/lists.datastax.com/forum/#!forum/java-driver-user
• IRC: #datastax-drivers on irc.freenode.net
• TWITTER: Follow the latest news about DataStax Drivers - @olim7t, @mfiguiere
• DOCS: the user guide has introductory material. We are progressively migrating the doc here with more technical details.
• API: http://www.datastax.com/drivers/java/2.1

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

Maven

b4d397c33abec1f42fa8a35869e219ef60c0e7e8

mvn install -Dmaven.test.skip=true

<<<<<<< HEAD

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

b4d397c33abec1f42fa8a35869e219ef60c0e7e8

生成Eclipse工程

<<<<<<< HEAD mvn eclipse:eclipse

在eclipse中导入
File->Import->General->Existing Projects into Workspace

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

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

b4d397c33abec1f42fa8a35869e219ef60c0e7e8

运行测试例子

<<<<<<< HEAD 在eclipse中可以直接运行my.test包中的例子

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.

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.

b4d397c33abec1f42fa8a35869e219ef60c0e7e8