Couchbase Java SDK 2.0.0 Beta 1
Originally written by Michael Nitschinger
On behalf of the whole SDK team I'm happy to announce the first beta release of the Java/JVM SDK release train nicknamed Armstrong. It contains both the JVM core package "core-io" 1.0.0-beta as well as the Java SDK 2.0.0-beta.
This beta release marks a milestone in that we're now locking down the API, only breaking them if absolutely necessary before the GA release. Also, we are releasing the first batch of documentation, which can be found here and also API docs which you can find here.
This blog covers the new-for-beta highlights. For a more conversational introduction to what's new in 2.0 in general, have a look at my blogs on the earlier developer preview releases: DP1, DP2, DP3 and the blog on Why Couchbase Chose RxJava.
Here is how you can get it:
<dependencies> <dependency> <groupId>com.couchbase.client</groupId> <artifactId>couchbase-client</artifactId> <version>2.0.0-beta</version> </dependency> </dependencies> <repositories> <repository> <id>couchbase</id> <name>couchbase repo</name> <url>http://files.couchbase.com/maven2</url> <snapshots><enabled>false</enabled></snapshots> </repository> </repositories>
Lots of APIs have been added, bugs have been ironed out and other components have been simplified. Here are the highlights:
Cluster-Level Management APIs
APIs have been added to allow the creation, deletion and retrieval of bucket information:
// Create the cluster reference Cluster cluster = CouchbaseCluster.create(); // Connect the Cluster Manager ClusterManager manager = cluster.clusterManager("Administrator", "password").toBlocking().single(); // Lists all configured buckets with their settings. Observable<BucketSettings> buckets = manager.getBuckets(); // Removes the beer-sample bucket Observable<Boolean> success = manager.removeBucket("beer-sample"); // Creates a new bucket Observable<BucketSettings> inserted = manager.insertBucket(DefaultBucketSettings .builder() .name("mybucket") .quota(512) .password("password") .enableFlush(true) .build());
Bucket-Level Management APIs
In additon to cluster-level APIs, also bucket level information can now be retrieved:
// Create the cluster reference Cluster cluster = CouchbaseCluster.create(); // Open the bucket Bucket bucket = cluster.openBucket().toBlocking().single(); // Open the bucket manager BucketManager manager = bucket.bucketManager().toBlocking().single(); // Flush the bucket Observable<Boolean> flush = manager.flush(); // Grab info BucketInfo info = manager.info().toBlocking().single();
The Environment API has been simplified and the properties, which were exposed in dp3 have been collapsed into the Environment itself. Customizing it now got even simpler:
// No more properties needed CouchbaseEnvironment env = DefaultCouchbaseEnvironment.builder() .queryEnabled(true) .build(); Cluster cluster = CouchbaseCluster.create(env);
This release brings us very close to a GA release in the next weeks. We are now shifting all focus onto stability and documentation, hopefully making this the best database SDK on the JVM out there. Please kick the tires on this beta release as much as you can, report any issues so we can resolve them in a timely manner.