com.amazonaws.services.dynamodbv2.util

Class TableUtils

java.lang.Object

com.amazonaws.services.dynamodbv2.util.TableUtils

public class TableUtils
extends Object

Utility methods for working with DynamoDB tables.

 // ... create DynamoDB table ...
 try {
        waitUntilActive(dynamoDB, myTableName());
 } catch (AmazonClientException e) {
        // table didn't become active
 }
 // ... start making calls to table ...
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TableUtils.TableNeverTransitionedToStateException Thrown by TableUtils when a table never reaches a desired state

Constructor Summary

Constructors

Constructor and Description
TableUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	waitUntilActive(AmazonDynamoDB dynamo, String tableName) Waits up to 10 minutes for a specified DynamoDB table to move into the ACTIVE state.
static void	waitUntilActive(AmazonDynamoDB dynamo, String tableName, int timeout, int interval) Waits up to a specified amount of time for a specified DynamoDB table to move into the ACTIVE state.
static void	waitUntilExists(AmazonDynamoDB dynamo, String tableName) Waits up to 10 minutes for a specified DynamoDB table to resolve, indicating that it exists.
static void	waitUntilExists(AmazonDynamoDB dynamo, String tableName, int timeout, int interval) Waits up to a specified amount of time for a specified DynamoDB table to resolve, indicating that it exists.

Methods inherited from class java.lang.Object

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

Constructor Detail

TableUtils

public TableUtils()

Method Detail

waitUntilExists

public static void waitUntilExists(AmazonDynamoDB dynamo,
                   String tableName)
                            throws InterruptedException

Waits up to 10 minutes for a specified DynamoDB table to resolve, indicating that it exists. If the table doesn't return a result after this time, an AmazonClientException is thrown.

Parameters:

dynamo - The DynamoDB client to use to make requests.

tableName - The name of the table being resolved.

Throws:

AmazonClientException - If the specified table does not resolve before this method times out and stops polling.

InterruptedException - If the thread is interrupted while waiting for the table to resolve.

waitUntilExists

public static void waitUntilExists(AmazonDynamoDB dynamo,
                   String tableName,
                   int timeout,
                   int interval)
                            throws InterruptedException

Waits up to a specified amount of time for a specified DynamoDB table to resolve, indicating that it exists. If the table doesn't return a result after this time, an AmazonClientException is thrown.

Parameters:

dynamo - The DynamoDB client to use to make requests.

tableName - The name of the table being resolved.

timeout - The maximum number of milliseconds to wait.

interval - The poll interval in milliseconds.

Throws:

AmazonClientException - If the specified table does not resolve before this method times out and stops polling.

InterruptedException - If the thread is interrupted while waiting for the table to resolve.

waitUntilActive

public static void waitUntilActive(AmazonDynamoDB dynamo,
                   String tableName)
                            throws InterruptedException,
                                   TableUtils.TableNeverTransitionedToStateException

Waits up to 10 minutes for a specified DynamoDB table to move into the ACTIVE state. If the table does not exist or does not transition to the ACTIVE state after this time, then an AmazonClientException is thrown.

Parameters:

dynamo - The DynamoDB client to use to make requests.

tableName - The name of the table whose status is being checked.

Throws:

TableUtils.TableNeverTransitionedToStateException - If the specified table does not exist or does not transition into the ACTIVE state before this method times out and stops polling.

InterruptedException - If the thread is interrupted while waiting for the table to transition into the ACTIVE state.

waitUntilActive

public static void waitUntilActive(AmazonDynamoDB dynamo,
                   String tableName,
                   int timeout,
                   int interval)
                            throws InterruptedException,
                                   TableUtils.TableNeverTransitionedToStateException

Waits up to a specified amount of time for a specified DynamoDB table to move into the ACTIVE state. If the table does not exist or does not transition to the ACTIVE state after this time, then an AmazonClientException is thrown.

Parameters:

dynamo - The DynamoDB client to use to make requests.

tableName - The name of the table whose status is being checked.

timeout - The maximum number of milliseconds to wait.

interval - The poll interval in milliseconds.

Throws:

TableUtils.TableNeverTransitionedToStateException - If the specified table does not exist or does not transition into the ACTIVE state before this method times out and stops polling.

InterruptedException - If the thread is interrupted while waiting for the table to transition into the ACTIVE state.