DynamoDB mapping API differences between version 1 and version 2 of the Amazon SDK for Java - Amazon SDK for Java 2.x
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

DynamoDB mapping API differences between version 1 and version 2 of the Amazon SDK for Java

The DynamoDB mapping APIs changed significantly between version 1 and version 2 of the Amazon SDK for Java. In version 1, you use the DynamoDBMapper to work with Java POJOs. In version 2, you use the DynamoDbEnhancedClient with updated method names, enhanced schema definition options, and improved type safety.

Key differences include:

  • New method names (such as getItem instead of load)

  • Explicit table schema creation

  • Built-in support for both synchronous and asynchronous operations

  • Changes in how empty strings and configuration are handled

This section covers the mapping API changes, annotation differences, configuration updates, and migration guidance to help you transition from the v1 DynamoDBMapper to the v2 DynamoDbEnhancedClient.

Contents