Couchbase Client Library: Java 1.1
		Next

Couchbase Client Library: Java 1.1

For documentation license information, see Documentation License. For all license information, see Licenses.

Abstract

This is the manual for 1.1 of the Couchbase Java client library, which is compatible with Couchbase Server 2.0.

This manual provides a reference to the key features and best practice for using the Java Couchbase Client library (couchbase-client).

Table 1. Product Compatibility for Couchbase SDK Java

Product	Compatible	All Features
Couchbase Server 1.8	✓	✓
Couchbase Server 2.0	✓	✓

External Community Resources.

Download Client Library

JavaDoc

Couchbase Developer Guide 2.0

Couchbase Server Manual 2.0

Java Client Library

SDK Forum

Wiki: Java Client Library

Last document update: 17 May 2013 01:57; Document built: 17 May 2013 01:57.

Documentation Availability and Formats. This documentation is available for download: HTML Zip, PDF, EPUB . For other documentation from Couchbase, see Couchbase Documentation Library

Contact: editors@couchbase.com or couchbase.com

Table of Contents

1. Getting Started

1.1. Preparations

1.1.1. Downloading the Couchbase Client Libraries
1.1.2. Setting up your IDE

1.2. Hello Couchbase

1.3. Working with Documents

1.3.1. Creating and Updating Documents
1.3.2. Reading Documents
1.3.3. Deleting Documents
1.3.4. JSON Encoding/Decoding

1.4. Advanced Topics

1.4.1. CAS and Locking
1.4.2. Persistence and Replication
1.4.3. View Queries with ComplexKeys

1.5. Next Steps

2. Tutorial

2.1. Quickstart

2.2. Preparations

2.2.1. Project Setup
2.2.2. Preparing the Views
2.2.3. Bootstrapping our Servlets: web.xml

2.3. Connection Management

2.4. The Welcome Page

2.5. Managing Beers

2.6. Wrapping Up

3. Using the APIs

3.1. Connecting to a Couchbase Bucket
3.2. Connecting using Hostname and Port with SASL
3.3. Setting runtime Parameters for the CouchbaseConnectionFactoryBuilder
3.4. Shutting down the Connection

4. Java Method Summary

4.1. Synchronous Method Calls
4.2. Asynchronous Method Calls
4.3. Object Serialization (Transcoding)
4.4. Expiry Values

5. Connection Operations

6. Store Operations

6.1. Add Operations
6.2. Set Operations
6.3. Store Operations with Durability Requirements

7. Retrieve Operations

7.1. Synchronous get Methods
7.2. Asynchronous get Methods
7.3. Get-and-Touch Methods
7.4. CAS get Methods
7.5. Bulk get Methods
7.6. Get and Lock
7.7. Unlock

8. Update Operations

8.1. Append Methods
8.2. Prepend Methods
8.3. Check-and-Set Methods
8.4. Delete Methods
8.5. Decrement Methods
8.6. Increment Methods
8.7. Replace Methods
8.8. Touch Methods

9. Statistics Operations

10. View/Query Interface

11. Java Troubleshooting

11.1. Configuring Logging
11.2. Handling Timeouts
11.3. Timing-out and Blocking
11.4. Bulk Load and Exponential Backoff
11.5. Retrying After Receiving a Temporary Failure
11.6. Java Virtual Machine Tuning Guidelines

A. Release Notes

A.1. Release Notes for Couchbase Client Library Java 1.1.6 GA (13 May 2013)
A.2. Release Notes for Couchbase Client Library Java 1.1.5 GA (4 April 2013)
A.3. Release Notes for Couchbase Client Library Java 1.1.4 GA (13 March 2013)
A.4. Release Notes for Couchbase Client Library Java 1.1.3 GA (4 March 2013)
A.5. Release Notes for Couchbase Client Library Java 1.1.2 GA (5 February 2013)
A.6. Release Notes for Couchbase Client Library Java 1.1.1 GA (23 January 2013)
A.7. Release Notes for Couchbase Client Library Java 1.1.0 GA (11 December 2012)
A.8. Release Notes for Couchbase Client Library Java 1.1-beta Beta (3 December 2012)
A.9. Release Notes for Couchbase Client Library Java 1.1-dp4 Developer Preview (29 October 2012)
A.10. Release Notes for Couchbase Client Library Java 1.1-dp3 Developer Preview (19 September 2012)
A.11. Release Notes for Couchbase Client Library Java 1.1-dp2 Developer Preview (23 August 2012)
A.12. Release Notes for Couchbase Client Library Java 1.1-dp Developer Preview (16 March 2012)

List of Tables

1. Product Compatibility for Couchbase SDK Java
3.1. Parameters that can be set via CouchbaseConnectionFactoryBuilder
4.1. Java Client Library Method Summary
4.2. Java Client Library Synchronous Method Summary
4.3. Java Client Library Asynchronous Method Summary
5.1. Java Client Library Connection Methods
6.1. Java Client Library Store Methods
7.1. Java Client Library Retrieval Methods
8.1. Java Client Library Update Methods
9.1. Java Client Library Statistics Methods

		Next
		Chapter 1. Getting Started