DynamoDB Examples Using the AWS SDK for Java - AWS SDK for Java 1.x
Use AWS account-based endpoints

The AWS SDK for Java 1.x has entered maintenance mode as of July 31, 2024, and will reach end-of-support on December 31, 2025. We recommend that you migrate to the AWS SDK for Java 2.x to continue receiving new features, availability improvements, and security updates.

DynamoDB Examples Using the AWS SDK for Java

This section provides examples of programming DynamoDB using the AWS SDK for Java.

Note

The examples include only the code needed to demonstrate each technique. The complete example code is available on GitHub. From there, you can download a single source file or clone the repository locally to get all the examples to build and run.

Topics

Use AWS account-based endpoints

DynamoDB offers AWS account-based endpoints that can improve performance by using your AWS account ID to streamline request routing.

To take advantage of this feature, you need to use version 1.12.771 or greater of version 1 of AWS SDK for Java. You can find the latest version of the SDK listed in the Maven central repository. After a supported version of SDK is active, it automatically uses the new endpoints.

If you want to opt out of the account-based routing, you have four options:

  • Configure a DynamoDB service client with the AccountIdEndpointMode set to DISABLED.

  • Set an environment variable.

  • Set a JVM system property.

  • Update the shared AWS config file setting.

The following snippet is an example of how to disable account-based routing by configuring a DynamoDB service client:

ClientConfiguration config = new ClientConfiguration()
    .withAccountIdEndpointMode(AccountIdEndpointMode.DISABLED);
AWSCredentialsProvider credentialsProvider = new EnvironmentVariableCredentialsProvider();

AmazonDynamoDB dynamodb = AmazonDynamoDBClientBuilder.standard()
    .withClientConfiguration(config)
    .withCredentials(credentialsProvider)
    .withRegion(Regions.US_WEST_2)
    .build();

The AWS SDKs and Tools Reference Guide provides more information on the last three configuration options.