Cambios de alto nivel en las bibliotecas asignación de la versión 1 a la 2 del SDK para Java - AWS SDK for Java 2.x

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cambios de alto nivel en las bibliotecas asignación de la versión 1 a la 2 del SDK para Java

Los nombres del cliente de asignación de cada biblioteca difieren en la V1 y en la V2:

  • V1: DynamoDBMapper

  • V2: Cliente mejorado de DynamoDB

Usted interactúa con las dos bibliotecas prácticamente de la misma forma: crea una instancia de asignador/cliente y, a continuación, proporciona un POJO de Java a las API que leen y escriben estos elementos en las tablas de DynamoDB. Ambas bibliotecas también ofrecen anotaciones para la clase del POJO para indicar la forma en que el cliente gestiona el POJO.

Diferencias notables al pasar a V2:

  • V2 y V1 utilizan nombres de métodos diferentes para las operaciones de DynamoDB de bajo nivel. Por ejemplo:

    V1 V2
    carga getItem
    save putItem
    batchLoad batchGetItem
  • V2 ofrece varias formas de definir esquemas de tabla y asignar POJO a tablas. Puede elegir entre el uso de anotaciones o un esquema generado a partir de código mediante un generador. V2 también ofrece versiones mutables e inmutables de los esquemas.

  • Con V2, se crea específicamente el esquema de tabla como uno de los primeros pasos, mientras que en V1, el esquema de tabla se deduce de la clase anotada según sea necesario.

  • V2 incluye el Cliente de la API de documento en la API de cliente mejorada, mientras que V1 usa una API aparte.

  • Todas las API están disponibles en versiones sincrónicas y asincrónicas en V2.

Consulte la sección de asignación de DynamoDB de esta guía para obtener información más detallada sobre el cliente mejorado de V2.

Diferencias en dependencia de importación

V1 V2
<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.X.X</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-dynamodb</artifactId> </dependency> </dependencies>
<dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>bom</artifactId> <version>2.X.X*</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>dynamodb-enhanced</artifactId> </dependency> </dependencies>

* Última versión.

En V1, una sola dependencia incluye la API de DynamoDB de bajo nivel y la API de asignación/documento, mientras que en V2 se usa la dependencia de artefactos de dynamodb-enhanced para acceder a la API de asignación/documento. El módulo dynamodb-enhanced contiene una dependencia transitiva del módulo dynamodb de bajo nivel.