DynamoDbAsyncIndex (AWS Java SDK :: DynamoDB :: Enhanced Client 2.16.21 API)

Type Parameters:

T - The type of the modelled object.

All Known Implementing Classes:

DefaultDynamoDbAsyncIndex
```
public interface DynamoDbAsyncIndex<T>
```
Asynchronous interface for running commands against an object that is linked to a specific DynamoDb secondary index and knows how to map records from the table that index is linked to into a modelled object.
By default, all command methods throw an UnsupportedOperationException to prevent interface extensions from breaking implementing classes.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`String`	`indexName()` Gets the physical secondary index name that operations performed by this object will be executed against.
`Key`	`keyFrom(T item)` Creates a `Key` object from a modelled item.
`DynamoDbEnhancedClientExtension`	`mapperExtension()` Gets the `DynamoDbEnhancedClientExtension` associated with this mapped resource.
`default SdkPublisher<Page<T>>`	`query(Consumer<QueryEnhancedRequest.Builder> requestConsumer)` Executes a query against a secondary index using a `QueryConditional` expression to retrieve a list of items matching the given conditions.
`default SdkPublisher<Page<T>>`	`query(QueryConditional queryConditional)` Executes a query against the secondary index of the table using a `QueryConditional` expression to retrieve a list of items matching the given conditions.
`default SdkPublisher<Page<T>>`	`query(QueryEnhancedRequest request)` Executes a query against a secondary index using a `QueryConditional` expression to retrieve a list of items matching the given conditions.
`default SdkPublisher<Page<T>>`	`scan()` Scans the table against a secondary index and retrieves all items using default settings.
`default SdkPublisher<Page<T>>`	`scan(Consumer<ScanEnhancedRequest.Builder> requestConsumer)` Scans the table against a secondary index and retrieves all items.
`default SdkPublisher<Page<T>>`	`scan(ScanEnhancedRequest request)` Scans the table against a secondary index and retrieves all items.
`String`	`tableName()` Gets the physical table name that operations performed by this object will be executed against.
`TableSchema<T>`	`tableSchema()` Gets the `TableSchema` object that this mapped table was built with.

- Method Detail
  - query
```
default SdkPublisher<Page<T>> query(QueryEnhancedRequest request)
```
    Executes a query against a secondary index using a QueryConditional expression to retrieve a list of items matching the given conditions.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a query call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page. Results are sorted by sort key value in ascending order by default; this behavior can be overridden in the QueryEnhancedRequest.
    The additional configuration parameters that the enhanced client supports are defined in the QueryEnhancedRequest.
    This operation calls the low-level DynamoDB API Query operation. Consult the Query documentation for further details and constraints.
    Example:
```
 

 QueryConditional queryConditional = QueryConditional.keyEqualTo(Key.builder().partitionValue("id-value").build());
 SdkPublisher<Page<MyItem>> publisher = mappedIndex.query(QueryEnhancedRequest.builder()
                                                                              .queryConditional(queryConditional)
                                                                              .build());
 
 
```
    Parameters:
    
    request - A QueryEnhancedRequest defining the query conditions and how to handle the results.
    
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - query
```
default SdkPublisher<Page<T>> query(Consumer<QueryEnhancedRequest.Builder> requestConsumer)
```
    Executes a query against a secondary index using a QueryConditional expression to retrieve a list of items matching the given conditions.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a query call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page. Results are sorted by sort key value in ascending order by default; this behavior can be overridden in the QueryEnhancedRequest.
    The additional configuration parameters that the enhanced client supports are defined in the QueryEnhancedRequest.
    This operation calls the low-level DynamoDB API Query operation. Consult the Query documentation for further details and constraints.
    Note: This is a convenience method that creates an instance of the request builder avoiding the need to create one manually via QueryEnhancedRequest.builder().
    Example:
```
 

 SdkPublisher<Page<MyItem>> publisher =
     mappedIndex.query(r -> r.queryConditional(QueryConditional.keyEqualTo(k -> k.partitionValue("id-value"))));
 
 
```
    Parameters:
    
    requestConsumer - A Consumer of QueryEnhancedRequest defining the query conditions and how to handle the results.
    
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - query
```
default SdkPublisher<Page<T>> query(QueryConditional queryConditional)
```
    Executes a query against the secondary index of the table using a QueryConditional expression to retrieve a list of items matching the given conditions.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a query call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page. Results are sorted by sort key value in ascending order.
    This operation calls the low-level DynamoDB API Query operation. Consult the Query documentation for further details and constraints.
    Example:
```
 

 SdkPublisher<Page<MyItem>> results =
     mappedIndex.query(QueryConditional.keyEqualTo(Key.builder().partitionValue("id-value").build()));
 
 
```
    Parameters:
    
    queryConditional - A QueryConditional defining the matching criteria for records to be queried.
    
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - scan
```
default SdkPublisher<Page<T>> scan(ScanEnhancedRequest request)
```
    Scans the table against a secondary index and retrieves all items.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a scan call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page.
    The additional configuration parameters that the enhanced client supports are defined in the ScanEnhancedRequest.
    Example:
```
 

 SdkPublisher<Page<MyItem>> publisher = mappedTable.scan(ScanEnhancedRequest.builder().consistentRead(true).build());
 
 
```
    Parameters:
    
    request - A ScanEnhancedRequest defining how to handle the results.
    
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - scan
```
default SdkPublisher<Page<T>> scan(Consumer<ScanEnhancedRequest.Builder> requestConsumer)
```
    Scans the table against a secondary index and retrieves all items.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a scan call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page.
    The additional configuration parameters that the enhanced client supports are defined in the ScanEnhancedRequest.
    Note: This is a convenience method that creates an instance of the request builder avoiding the need to create one manually via ScanEnhancedRequest.builder().
    Example:
```
 

 SdkPublisher<Page<MyItem>> publisher = mappedTable.scan(r -> r.limit(5));
 
 
```
    Parameters:
    
    requestConsumer - A Consumer of ScanEnhancedRequest defining the query conditions and how to handle the results.
    
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - scan
```
default SdkPublisher<Page<T>> scan()
```
    Scans the table against a secondary index and retrieves all items using default settings.
    The result is accessed through iterable pages (see Page) in an interactive way; each time a result page is retrieved, a scan call is made to DynamoDb to get those entries. If no matches are found, the resulting iterator will contain an empty page.
    Example:
```
 

 SdkPublisher<Page<MyItem>> publisher = mappedTable.scan();
 
 
```
    Returns:
    
    a publisher SdkPublisher with paginated results (see Page).
  - mapperExtension
```
DynamoDbEnhancedClientExtension mapperExtension()
```
    Gets the DynamoDbEnhancedClientExtension associated with this mapped resource.
    
    Returns:
    
    The DynamoDbEnhancedClientExtension associated with this mapped resource.
  - tableSchema
```
TableSchema<T> tableSchema()
```
    Gets the TableSchema object that this mapped table was built with.
    
    Returns:
    
    The TableSchema object for this mapped table.
  - tableName
```
String tableName()
```
    Gets the physical table name that operations performed by this object will be executed against.
    
    Returns:
    
    The physical table name.
  - indexName
```
String indexName()
```
    Gets the physical secondary index name that operations performed by this object will be executed against.
    
    Returns:
    
    The physical secondary index name.
  - keyFrom
```
Key keyFrom(T item)
```
    Creates a Key object from a modelled item. This key can be used in query conditionals and get operations to locate a specific record.
    
    Parameters:
    
    item - The item to extract the key fields from.
    
    Returns:
    
    A key that has been initialized with the index values extracted from the modelled object.

Interface DynamoDbAsyncIndex<T>

Method Summary

Method Detail

query

query

query

scan

scan

scan

mapperExtension

tableSchema

tableName

indexName

keyFrom