com.amazonaws.services.dynamodb.AmazonDynamoDBAsync Maven / Gradle / Ivy
/*
* Copyright 2010-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
package com.amazonaws.services.dynamodb;
import java.util.concurrent.Future;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.handlers.AsyncHandler;
import com.amazonaws.services.dynamodb.model.*;
/**
* Interface for accessing AmazonDynamoDB asynchronously.
* Each asynchronous method will return a Java Future object, and users are also allowed
* to provide a callback handler.
*
* Amazon DynamoDB is a fast, highly scalable, highly available, cost-effective non-relational database service.
*
*
* Amazon DynamoDB removes traditional scalability limitations on data storage while maintaining low latency and predictable performance.
*
* @deprecated Use {@link com.amazonaws.services.dynamodbv2.AmazonDynamoDBAsync} instead.
*/
@Deprecated
public interface AmazonDynamoDBAsync extends AmazonDynamoDB {
/**
*
* Retrieves a paginated list of table names created by the AWS Account
* of the caller in the AWS Region (e.g. us-east-1 ).
*
*
* @param listTablesRequest Container for the necessary parameters to
* execute the ListTables operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* ListTables service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future listTablesAsync(ListTablesRequest listTablesRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves a paginated list of table names created by the AWS Account
* of the caller in the AWS Region (e.g. us-east-1 ).
*
*
* @param listTablesRequest Container for the necessary parameters to
* execute the ListTables operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* ListTables service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future listTablesAsync(ListTablesRequest listTablesRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Gets the values of one or more items and its attributes by primary key
* (composite primary key, only).
*
*
* Narrow the scope of the query using comparison operators on the
* RangeKeyValue of the composite key. Use the
* ScanIndexForward parameter to get results in forward or
* reverse order by range key.
*
*
* @param queryRequest Container for the necessary parameters to execute
* the Query operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the Query
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future queryAsync(QueryRequest queryRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Gets the values of one or more items and its attributes by primary key
* (composite primary key, only).
*
*
* Narrow the scope of the query using comparison operators on the
* RangeKeyValue of the composite key. Use the
* ScanIndexForward parameter to get results in forward or
* reverse order by range key.
*
*
* @param queryRequest Container for the necessary parameters to execute
* the Query operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the Query
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future queryAsync(QueryRequest queryRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Allows to execute a batch of Put and/or Delete Requests for many
* tables in a single call. A total of 25 requests are allowed.
*
*
* There are no transaction guarantees provided by this API. It does not
* allow conditional puts nor does it support return values.
*
*
* @param batchWriteItemRequest Container for the necessary parameters to
* execute the BatchWriteItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* BatchWriteItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future batchWriteItemAsync(BatchWriteItemRequest batchWriteItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Allows to execute a batch of Put and/or Delete Requests for many
* tables in a single call. A total of 25 requests are allowed.
*
*
* There are no transaction guarantees provided by this API. It does not
* allow conditional puts nor does it support return values.
*
*
* @param batchWriteItemRequest Container for the necessary parameters to
* execute the BatchWriteItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* BatchWriteItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future batchWriteItemAsync(BatchWriteItemRequest batchWriteItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Edits an existing item's attributes.
*
*
* You can perform a conditional update (insert a new attribute
* name-value pair if it doesn't exist, or replace an existing name-value
* pair if it has certain expected attribute values).
*
*
* @param updateItemRequest Container for the necessary parameters to
* execute the UpdateItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* UpdateItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future updateItemAsync(UpdateItemRequest updateItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Edits an existing item's attributes.
*
*
* You can perform a conditional update (insert a new attribute
* name-value pair if it doesn't exist, or replace an existing name-value
* pair if it has certain expected attribute values).
*
*
* @param updateItemRequest Container for the necessary parameters to
* execute the UpdateItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* UpdateItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future updateItemAsync(UpdateItemRequest updateItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Creates a new item, or replaces an old item with a new item (including
* all the attributes).
*
*
* If an item already exists in the specified table with the same primary
* key, the new item completely replaces the existing item. You can
* perform a conditional put (insert a new item if one with the specified
* primary key doesn't exist), or replace an existing item if it has
* certain attribute values.
*
*
* @param putItemRequest Container for the necessary parameters to
* execute the PutItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the PutItem
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future putItemAsync(PutItemRequest putItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Creates a new item, or replaces an old item with a new item (including
* all the attributes).
*
*
* If an item already exists in the specified table with the same primary
* key, the new item completely replaces the existing item. You can
* perform a conditional put (insert a new item if one with the specified
* primary key doesn't exist), or replace an existing item if it has
* certain attribute values.
*
*
* @param putItemRequest Container for the necessary parameters to
* execute the PutItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the PutItem
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future putItemAsync(PutItemRequest putItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves information about the table, including the current status of
* the table, the primary key schema and when the table was created.
*
*
* If the table does not exist, Amazon DynamoDB returns a
* ResourceNotFoundException .
*
*
* @param describeTableRequest Container for the necessary parameters to
* execute the DescribeTable operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* DescribeTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future describeTableAsync(DescribeTableRequest describeTableRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves information about the table, including the current status of
* the table, the primary key schema and when the table was created.
*
*
* If the table does not exist, Amazon DynamoDB returns a
* ResourceNotFoundException .
*
*
* @param describeTableRequest Container for the necessary parameters to
* execute the DescribeTable operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* DescribeTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future describeTableAsync(DescribeTableRequest describeTableRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves one or more items and its attributes by performing a full
* scan of a table.
*
*
* Provide a ScanFilter to get more specific results.
*
*
* @param scanRequest Container for the necessary parameters to execute
* the Scan operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the Scan
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future scanAsync(ScanRequest scanRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves one or more items and its attributes by performing a full
* scan of a table.
*
*
* Provide a ScanFilter to get more specific results.
*
*
* @param scanRequest Container for the necessary parameters to execute
* the Scan operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the Scan
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future scanAsync(ScanRequest scanRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Adds a new table to your account.
*
*
* The table name must be unique among those associated with the AWS
* Account issuing the request, and the AWS Region that receives the
* request (e.g. us-east-1 ).
*
*
* The CreateTable operation triggers an asynchronous
* workflow to begin creating the table. Amazon DynamoDB immediately
* returns the state of the table ( CREATING ) until the
* table is in the ACTIVE state. Once the table is in the
* ACTIVE state, you can perform data plane operations.
*
*
* @param createTableRequest Container for the necessary parameters to
* execute the CreateTable operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* CreateTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future createTableAsync(CreateTableRequest createTableRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Adds a new table to your account.
*
*
* The table name must be unique among those associated with the AWS
* Account issuing the request, and the AWS Region that receives the
* request (e.g. us-east-1 ).
*
*
* The CreateTable operation triggers an asynchronous
* workflow to begin creating the table. Amazon DynamoDB immediately
* returns the state of the table ( CREATING ) until the
* table is in the ACTIVE state. Once the table is in the
* ACTIVE state, you can perform data plane operations.
*
*
* @param createTableRequest Container for the necessary parameters to
* execute the CreateTable operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* CreateTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future createTableAsync(CreateTableRequest createTableRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Updates the provisioned throughput for the given table.
*
*
* Setting the throughput for a table helps you manage performance and is
* part of the Provisioned Throughput feature of Amazon DynamoDB.
*
*
* @param updateTableRequest Container for the necessary parameters to
* execute the UpdateTable operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* UpdateTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future updateTableAsync(UpdateTableRequest updateTableRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Updates the provisioned throughput for the given table.
*
*
* Setting the throughput for a table helps you manage performance and is
* part of the Provisioned Throughput feature of Amazon DynamoDB.
*
*
* @param updateTableRequest Container for the necessary parameters to
* execute the UpdateTable operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* UpdateTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future updateTableAsync(UpdateTableRequest updateTableRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Deletes a table and all of its items.
*
*
* If the table is in the ACTIVE state, you can delete it.
* If a table is in CREATING or UPDATING states
* then Amazon DynamoDB returns a ResourceInUseException .
* If the specified table does not exist, Amazon DynamoDB returns a
* ResourceNotFoundException .
*
*
* @param deleteTableRequest Container for the necessary parameters to
* execute the DeleteTable operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* DeleteTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future deleteTableAsync(DeleteTableRequest deleteTableRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Deletes a table and all of its items.
*
*
* If the table is in the ACTIVE state, you can delete it.
* If a table is in CREATING or UPDATING states
* then Amazon DynamoDB returns a ResourceInUseException .
* If the specified table does not exist, Amazon DynamoDB returns a
* ResourceNotFoundException .
*
*
* @param deleteTableRequest Container for the necessary parameters to
* execute the DeleteTable operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* DeleteTable service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future deleteTableAsync(DeleteTableRequest deleteTableRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Deletes a single item in a table by primary key.
*
*
* You can perform a conditional delete operation that deletes the item
* if it exists, or if it has an expected attribute value.
*
*
* @param deleteItemRequest Container for the necessary parameters to
* execute the DeleteItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* DeleteItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future deleteItemAsync(DeleteItemRequest deleteItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Deletes a single item in a table by primary key.
*
*
* You can perform a conditional delete operation that deletes the item
* if it exists, or if it has an expected attribute value.
*
*
* @param deleteItemRequest Container for the necessary parameters to
* execute the DeleteItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* DeleteItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future deleteItemAsync(DeleteItemRequest deleteItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves a set of Attributes for an item that matches the primary
* key.
*
*
* The GetItem operation provides an eventually-consistent
* read by default. If eventually-consistent reads are not acceptable for
* your application, use ConsistentRead . Although this
* operation might take longer than a standard read, it always returns
* the last updated value.
*
*
* @param getItemRequest Container for the necessary parameters to
* execute the GetItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the GetItem
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future getItemAsync(GetItemRequest getItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves a set of Attributes for an item that matches the primary
* key.
*
*
* The GetItem operation provides an eventually-consistent
* read by default. If eventually-consistent reads are not acceptable for
* your application, use ConsistentRead . Although this
* operation might take longer than a standard read, it always returns
* the last updated value.
*
*
* @param getItemRequest Container for the necessary parameters to
* execute the GetItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the GetItem
* service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future getItemAsync(GetItemRequest getItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves the attributes for multiple items from multiple tables using
* their primary keys.
*
*
* The maximum number of item attributes that can be retrieved for a
* single operation is 100. Also, the number of items retrieved is
* constrained by a 1 MB the size limit. If the response size limit is
* exceeded or a partial result is returned due to an internal processing
* failure, Amazon DynamoDB returns an UnprocessedKeys value
* so you can retry the operation starting with the next item to get.
*
*
* Amazon DynamoDB automatically adjusts the number of items returned per
* page to enforce this limit. For example, even if you ask to retrieve
* 100 items, but each individual item is 50k in size, the system returns
* 20 items and an appropriate UnprocessedKeys value so you
* can get the next page of results. If necessary, your application needs
* its own logic to assemble the pages of results into one set.
*
*
* @param batchGetItemRequest Container for the necessary parameters to
* execute the BatchGetItem operation on AmazonDynamoDB.
*
* @return A Java Future object containing the response from the
* BatchGetItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future batchGetItemAsync(BatchGetItemRequest batchGetItemRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves the attributes for multiple items from multiple tables using
* their primary keys.
*
*
* The maximum number of item attributes that can be retrieved for a
* single operation is 100. Also, the number of items retrieved is
* constrained by a 1 MB the size limit. If the response size limit is
* exceeded or a partial result is returned due to an internal processing
* failure, Amazon DynamoDB returns an UnprocessedKeys value
* so you can retry the operation starting with the next item to get.
*
*
* Amazon DynamoDB automatically adjusts the number of items returned per
* page to enforce this limit. For example, even if you ask to retrieve
* 100 items, but each individual item is 50k in size, the system returns
* 20 items and an appropriate UnprocessedKeys value so you
* can get the next page of results. If necessary, your application needs
* its own logic to assemble the pages of results into one set.
*
*
* @param batchGetItemRequest Container for the necessary parameters to
* execute the BatchGetItem operation on AmazonDynamoDB.
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the implementation of
* the four callback methods in this interface to process the operation
* result or handle the exception.
*
* @return A Java Future object containing the response from the
* BatchGetItem service method, as returned by AmazonDynamoDB.
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonDynamoDB indicating
* either a problem with the data in the request, or a server side issue.
*/
public Future batchGetItemAsync(BatchGetItemRequest batchGetItemRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
}