software.amazon.awssdk.extensions.dynamodb.mappingclient

Interface AsyncMappedTable<T>

Type Parameters:

T - The type of the modelled object.

All Superinterfaces:

MappedTableResource<T>

All Known Implementing Classes:

DynamoDbAsyncMappedTable

public interface AsyncMappedTable<T>
extends MappedTableResource<T>

Asynchronous interface for running commands against an object that is linked to a specific DynamoDb table resource and therefore knows how to map records from that table into a modelled object.

Method Summary

Modifier and Type	Method and Description
<R> SdkPublisher<R>	execute(PaginatedTableOperation<T,?,?,R> operationToPerform) Executes a command that is expected to return a paginated list of data items against the database with the context of the primary index of the specific table this object is linked to.
<R> CompletableFuture<R>	execute(TableOperation<T,?,?,R> operationToPerform) Executes a command that is expected to return a single data item against the database with the context of the primary index of the specific table this object is linked to.
AsyncMappedIndex<T>	index(String indexName) Returns a mapped index that can be used to execute commands against a secondary index belonging to the table being mapped by this object.

Methods inherited from interface software.amazon.awssdk.extensions.dynamodb.mappingclient.MappedTableResource

keyFrom, mapperExtension, tableName, tableSchema

Method Detail

index

AsyncMappedIndex<T> index(String indexName)

Returns a mapped index that can be used to execute commands against a secondary index belonging to the table being mapped by this object. Note that only a subset of the commands that work against a table will work against a secondary index.

Parameters:

indexName - The name of the secondary index to build the command interface for.

Returns:

An AsyncMappedIndex object that can be used to execute database commands against.

execute

<R> CompletableFuture<R> execute(TableOperation<T,?,?,R> operationToPerform)

Executes a command that is expected to return a single data item against the database with the context of the primary index of the specific table this object is linked to.

Type Parameters:

R - The expected return type from the operation. This is typically inferred by the compiler.

Parameters:

operationToPerform - The operation to be performed in the context of the primary index of the table.

Returns:

A CompletableFuture that will return the result of the operation being executed. The documentation on the operation itself should have more information.

execute

<R> SdkPublisher<R> execute(PaginatedTableOperation<T,?,?,R> operationToPerform)

Executes a command that is expected to return a paginated list of data items against the database with the context of the primary index of the specific table this object is linked to.

Type Parameters:

R - The expected return type from the operation. This is typically inferred by the compiler.

Parameters:

operationToPerform - The operation to be performed in the context of the primary index of the table.

Returns:

An SdkPublisher that will publish successive pages of result data items to any subscriber with demand for them.