Package io.deephaven.kv

Interface KVClient

All Known Implementing Classes:

KVClientEtcd

public interface KVClient

KVClient is the interface for executing Requests against a key-value store, adapting the appropriate Response, and invoking Response.linkToRequest().

Execution is linearizable. That is, execution logic proceeds as if they were run in order. (The ordering is reflected through modification revisions, as returned by KeyValue.getModificationRevision().)

Note: KVClient does not support executing Delete, nor DeletePrefix, requests directly. Destructive requests should be wrapped up as necessary inside an appropriate Transaction.

Method Summary

Modifier and Type	Method	Description
CompletableFuture<HeaderResponse>	execute(Get get)	Executes a get request against a kv store.
CompletableFuture<HeaderResponse>	execute(GetPrefix getPrefix)	Executes a get prefix request against a kv store.
CompletableFuture<HeaderResponse>	execute(Transaction transaction)	Executes a transaction request against a kv store.

Method Details

execute

CompletableFuture<HeaderResponse> execute(Transaction transaction)

Executes a transaction request against a kv store.

After successful completion of the returned future, Transaction.hasResponse() will be true.

Parameters:

transaction - the transaction to execute

Returns:

a completable future with header representing the state of the store

execute

CompletableFuture<HeaderResponse> execute(GetPrefix getPrefix)

Executes a get prefix request against a kv store.

After successful completion of the returned future, GetPrefix.hasResponse() will be true.

Parameters:

getPrefix - the get prefix request to execute

Returns:

a completable future with header representing the state of the kv store

execute

CompletableFuture<HeaderResponse> execute(Get get)

Executes a get request against a kv store.

After successful completion of the returned future, Get.hasResponse() will be true.

Parameters:

get - the get request to execute

Returns:

a completable future with header representing the state of the kv store