Package com.basho.riak.client.bucket

A bucket is a namespace abstraction provided by Riak, the API uses Bucket as the primary way to interact with data stored in Riak.

See:
Description

Interface Summary

Bucket	The primary interface for working with Key/Value data in Riak, a factory for key/value RiakOperations.
BucketProperties	The set of properties for a bucket, things like n_val, allow_mult, default read quorum.

Class Summary

DefaultBucket	Default implementation of Bucket for creating RiakOperations on k/v data and accessing BucketProperties.
DefaultBucketProperties	An immutable implementation of BucketProperties.
DomainBucket<T>	A domain bucket is a wrapper around a Bucket that is strongly typed and uses a preset ConflictResolver, MutationProducer, Converter, r, w, dw, rw, Retrier, returnBody etc
FetchBucket	A RiakOperation that gets a Bucket from Riak.
LazyBucketProperties	A lazy loading BucketProperties.
RiakBucket	Wraps a DomainBucket strongly typed for IRiakObject.
TunableCAPProps	Parameter wrapper class for the growing number of tunable CAP knobs on Riak
VClockPruneProps	Parameter wrapper class for the set of vclock prune properties
WriteBucket	A RiakOperation for creating/updating a Bucket.

Exception Summary

UnsupportedPropertyException

Package com.basho.riak.client.bucket Description

A bucket is a namespace abstraction provided by Riak, the API uses Bucket as the primary way to interact with data stored in Riak.

All data in Riak is stored under a bucket/key namespace. After you have obtained a Bucket from the IRiakClient, use it to fetch, store and delete data.

For example

 
   final String bucketName = UUID.randomUUID().toString();
   
   Bucket b = client.fetchBucket(bucketName).execute();
   //store something
   IRiakObject o = b.store("k", "v").execute();
   //fetch it back
   IRiakObject fetched = b.fetch("k").execute();
   // now update that riak object
   b.store("k", "my new value").execute();
   //fetch it back again
   fetched = b.fetch("k").execute();
   //delete it
   b.delete("k").execute();
 

Bucket extends the BucketProperties interface for access to bucket schema information (like n_val, allow_mult, default r quorum etc.)

This package also provides a DomainBucket for wrapping a Bucket. A DomainBucket simplifies working with a bucket that only has one type of data in it. RiakBucket is a DomainBucket for working with IRiakObjects.

See Also:

Bucket, DomainBucket, RiakBucket