com.basho.riak.client.api.commands.kv

Class FetchValue

java.lang.Object

com.basho.riak.client.api.RiakCommand<R,I>

com.basho.riak.client.api.GenericRiakCommand<R,I,CoreR,I>

com.basho.riak.client.api.GenericRiakCommand.GenericRiakCommandWithSameInfo<FetchValue.Response,Location,FetchOperation.Response>

com.basho.riak.client.api.commands.kv.FetchValue

public final class FetchValue
extends GenericRiakCommand.GenericRiakCommandWithSameInfo<FetchValue.Response,Location,FetchOperation.Response>

Command used to fetch a value from Riak.

Fetching an object from Riak is a simple matter of supplying a Location and executing the FetchValue operation.

 Namespace ns = new Namespace("my_type","my_bucket");
 Location loc = new Location(ns, "my_key");
 FetchValue fv = new FetchValue.Builder(loc).build();
 FetchValue.Response response = client.execute(fv);
 RiakObject obj = response.getValue(RiakObject.class);

All operations can called async as well.

 ...
 RiakFuture<FetchValue.Response, Location> future = client.executeAsync(fv);
 ...
 future.await();
 if (future.isSuccess())
 {
     ...
 }

ORM features are also provided when retrieving the results from the response. By default, JSON serialization / deserializtion is used. For example, if the value stored in Riak was JSON and mapped to your class MyPojo:

 ...
 MyPojo mp = response.getValue(MyPojo.class);
 ...

Since:

2.0

Author:

Dave Rusek

See Also:

FetchValue.Response

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FetchValue.Builder Used to construct a FetchValue command.
static class	FetchValue.Option<T> Options for controlling how Riak performs the fetch operation.
static class	FetchValue.Response A response from Riak containing results from a FetchValue command.

Nested classes/interfaces inherited from class com.basho.riak.client.api.GenericRiakCommand

GenericRiakCommand.GenericRiakCommandWithSameInfo<R,I,CoreR>

Method Summary

Modifier and Type	Method and Description
protected FetchOperation	buildCoreOperation()
protected FetchValue.Response	convertResponse(FutureOperation<FetchOperation.Response,?,Location> request, FetchOperation.Response coreResponse)
boolean	equals(Object obj)
protected RiakFuture<FetchValue.Response,Location>	executeAsync(RiakCluster cluster)
int	hashCode()
String	toString()

Methods inherited from class com.basho.riak.client.api.GenericRiakCommand.GenericRiakCommandWithSameInfo

convertInfo

Methods inherited from class com.basho.riak.client.api.RiakCommand

execute, execute

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

executeAsync

protected final RiakFuture<FetchValue.Response,Location> executeAsync(RiakCluster cluster)

Overrides:

executeAsync in class GenericRiakCommand<FetchValue.Response,Location,FetchOperation.Response,Location>

convertResponse

protected FetchValue.Response convertResponse(FutureOperation<FetchOperation.Response,?,Location> request,
                                              FetchOperation.Response coreResponse)

Specified by:

convertResponse in class GenericRiakCommand<FetchValue.Response,Location,FetchOperation.Response,Location>

buildCoreOperation

protected FetchOperation buildCoreOperation()

Specified by:

buildCoreOperation in class GenericRiakCommand<FetchValue.Response,Location,FetchOperation.Response,Location>

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object