io.fluxcapacitor.javaclient.keyvalue.client

Interface KeyValueClient

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

InMemoryKeyValueClient, WebsocketKeyValueClient

public interface KeyValueClient
extends AutoCloseable

Represents a service to store and retrieve a piece of serialized data by key.

Method Summary

Modifier and Type	Method and Description
void	close()
Awaitable	deleteValue(String key) Deletes the value associated with the given key.
Data<byte[]>	getValue(String key) Returns the Data object associated with the given key.
Awaitable	putValue(String key, Data<byte[]> value) Adds or replaces the given value in the key value store.

Method Detail

putValue

Awaitable putValue(String key,
                   Data<byte[]> value)

Adds or replaces the given value in the key value store.

Parameters:

key - The key associated with this value

value - The value to store

Returns:

a handle that enables clients to wait until the value was safely sent to the store

getValue

Data<byte[]> getValue(String key)

Returns the Data object associated with the given key. Returns null if there is no associated value.

Parameters:

key - The key associated with the value

Returns:

the value for the given key or null

deleteValue

Awaitable deleteValue(String key)

Deletes the value associated with the given key.

Parameters:

key - The key associated with this value

Returns:

a handle that enables clients to wait until the command was safely sent to the store

close

void close()

Specified by:

close in interface AutoCloseable