Cambios de alto nivel en las bibliotecas de mapeo de la versión 1 a la versión 2 del SDK for Java - AWS SDK for Java 2.x
Importar diferencias de dependencia

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 de mapeo de la versión 1 a la versión 2 del SDK for Java

Los nombres del cliente de mapeo de cada biblioteca difieren en la V1 y en la V2:

  • V1: Dynamo DBMapper

  • V2: Cliente mejorado de DynamoDB

Se interactúa con las dos bibliotecas prácticamente de la misma manera: se crea una instancia mapper/client y, a continuación, se proporciona un POJO de Java para leer y escribir estos APIs elementos en las tablas de DynamoDB. Ambas bibliotecas también ofrecen anotaciones para la clase del POJO a fin de indicar la forma en que el cliente gestiona el POJO.

Las diferencias notables al pasar a la V2 incluyen:

  • 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

  • La versión 2 ofrece varias formas de definir esquemas de tablas y mapearlos en tablas. POJOs Puede elegir entre el uso de anotaciones o un esquema generado a partir del código mediante un generador. V2 también ofrece versiones mutables e inmutables de los esquemas.

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

  • La versión 2 incluye el cliente Document API en la API de cliente mejorada, mientras que la versión 1 usa una API independiente.

  • Todas APIs están disponibles en versiones síncronas y asíncronas en la versión 2.

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

Importar diferencias de dependencia

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 la versión 1, una sola dependencia incluye tanto la API de DynamoDB de bajo nivel como mapping/document la API, mientras que en la versión 2, se utiliza dynamodb-enhanced la dependencia de artefactos para acceder a la API. mapping/document El dynamodb-enhanced módulo contiene una dependencia transitiva del módulo de nivel inferior. dynamodb