Package io.pravega.client.tables.impl

Class KeyValueTableImpl

java.lang.Object

io.pravega.client.tables.impl.KeyValueTableImpl

All Implemented Interfaces:

KeyValueTable, java.lang.AutoCloseable

public class KeyValueTableImpl
extends java.lang.Object
implements KeyValueTable, java.lang.AutoCloseable

Implementation for KeyValueTable.

Field Summary

Fields inherited from interface io.pravega.client.tables.KeyValueTable

MAXIMUM_VALUE_LENGTH

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the KeyValueTable.
java.util.concurrent.CompletableFuture<java.lang.Boolean>	exists(@NonNull TableKey key)	Determines if the given TableKey exists or not.
java.util.concurrent.CompletableFuture<TableEntry>	get(@NonNull TableKey key)	Gets the latest value for a TableKey.
java.util.concurrent.CompletableFuture<java.util.List<TableEntry>>	getAll(@NonNull java.lang.Iterable<TableKey> keys)	Gets the latest values for a set of TableKeys.
io.pravega.client.tables.impl.KeyValueTableIteratorImpl.Builder	iterator()	Creates a new KeyValueTableIterator.Builder that can be used to construct and execute an Iterator over the TableKey/TableEntry instances in this KeyValueTable.
java.util.concurrent.CompletableFuture<Version>	update(@NonNull TableModification update)	Performs a specific TableModification to the KeyValueTable, as described below: If update is a Insert, this will be interpreted as a Conditional Insert, so the TableEntryUpdate.getValue() will only be inserted (and associated with TableModification.getKey() if there doesn't already exist a TableKey in the KeyValueTable that matches TableModification.getKey().
java.util.concurrent.CompletableFuture<java.util.List<Version>>	update(@NonNull java.lang.Iterable<TableModification> updates)	Performs a batch of TableModifications to the KeyValueTable for TableKeys that have the same TableKey.getPrimaryKey().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public void close()

Description copied from interface: KeyValueTable

Closes the KeyValueTable. No more updates, removals, retrievals or iterators may be performed using it.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface KeyValueTable

See Also:

AutoCloseable.close()

update

public java.util.concurrent.CompletableFuture<Version> update(@NonNull
                                                              @NonNull TableModification update)

Description copied from interface: KeyValueTable

Performs a specific TableModification to the KeyValueTable, as described below:

• If update is a Insert, this will be interpreted as a Conditional Insert, so the TableEntryUpdate.getValue() will only be inserted (and associated with TableModification.getKey() if there doesn't already exist a TableKey in the KeyValueTable that matches TableModification.getKey().
• If update is a Put, this will be an update. If Put.getVersion() is null, this will be interpreted as an Unconditional Update, and the TableEntryUpdate.getValue() will be associated with TableModification.getKey() in the KeyValueTable regardless of whether the Key existed before or not. If Put.getVersion() is non-null, this will be interpreted as a Conditional Update, and the TableEntryUpdate.getValue() will only be associated with TableModification.getKey() if there exists a TableKey in the KeyValueTable whose Version matches Put.getVersion(). NOTE: if Put.getVersion() equals Version.NOT_EXISTS, this is equivalent to Insert (i.e., it will be a Conditional Insert).
• If update is a Remove, this will remove the TableModification.getKey() from the KeyValueTable. If Remove.getVersion() is null, this will be interpreted as an Unconditional Removal, so the Key will be removed regardless of its Version (and the operation will also be successful if the TableModification.getKey() does not exist). If Remove.getVersion() is non-null, this will be interpreted as a Conditional Removal, and the Key will only be removed if it exists and its Version matches Remove.getVersion().

Specified by:

update in interface KeyValueTable

Parameters:

update - The TableModification to apply to the KeyValueTable.

Returns:

A CompletableFuture that, when completed, will contain the Version associated with any newly updated or inserted entry (for Insert or Put) or null for Remove.

update

public java.util.concurrent.CompletableFuture<java.util.List<Version>> update(@NonNull
                                                                              @NonNull java.lang.Iterable<TableModification> updates)

Description copied from interface: KeyValueTable

Performs a batch of TableModifications to the KeyValueTable for TableKeys that have the same TableKey.getPrimaryKey(). All changes are performed atomically (either all or none will be accepted).

See KeyValueTable.update(TableModification) for details on Conditional/Unconditional Updates. Conditional and unconditional updates may be mixed together in this call. Each individual TableModification will be individually assessed (from a conditional point of view) and will prevent the entire batch from committing if it fails to meet the condition.

Specified by:

update in interface KeyValueTable

Parameters:

updates - An Iterable of TableModifications to apply to the KeyValueTable. Note that Remove instances may not be mixed together with Insert or Put instances, but Inserts and Puts may be mixed together.

Returns:

A CompletableFuture that, when completed, will contain a List of Version instances which represent the versions for the updated or inserted keys. The size of this list will be the same as the number of items in updates and the versions will be in the same order as the updates. This list will be empty if updates contains only Remove instances.

exists

public java.util.concurrent.CompletableFuture<java.lang.Boolean> exists(@NonNull
                                                                        @NonNull TableKey key)

Description copied from interface: KeyValueTable

Determines if the given TableKey exists or not.

Specified by:

exists in interface KeyValueTable

Parameters:

key - The TableKey to check.

Returns:

A CompletableFuture that, when completed, will contain a Boolean representing the result.

get

public java.util.concurrent.CompletableFuture<TableEntry> get(@NonNull
                                                              @NonNull TableKey key)

Description copied from interface: KeyValueTable

Gets the latest value for a TableKey.

Specified by:

get in interface KeyValueTable

Parameters:

key - The TableKey to get the value for.

Returns:

A CompletableFuture that, when completed, will contain the requested result. If no such TableKey exists, this will be completed with a null value.

getAll

public java.util.concurrent.CompletableFuture<java.util.List<TableEntry>> getAll(@NonNull
                                                                                 @NonNull java.lang.Iterable<TableKey> keys)

Description copied from interface: KeyValueTable

Gets the latest values for a set of TableKeys.

Specified by:

getAll in interface KeyValueTable

Parameters:

keys - An Iterable of @link TableKey} to get values for.

Returns:

A CompletableFuture that, when completed, will contain a List of TableEntry instances for the requested keys. The size of the list will be the same as keys.size() and the results will be in the same order as the requested keys. Any keys which do not have a value will have a null entry at their index.

iterator

public io.pravega.client.tables.impl.KeyValueTableIteratorImpl.Builder iterator()

Description copied from interface: KeyValueTable

Creates a new KeyValueTableIterator.Builder that can be used to construct and execute an Iterator over the TableKey/TableEntry instances in this KeyValueTable.

Specified by:

iterator in interface KeyValueTable

Returns:

A new instance of a KeyValueTableIterator.Builder.