Alterações de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK para Java - AWS SDK for Java 2.x
Importar diferenças de dependência

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Alterações de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK para Java

Os nomes do cliente de mapeamento em cada biblioteca diferem da V1 para a V2:

  • V1: DynamoDBMapper

  • V2: Cliente Aprimorado do DynamoDB

Você interage com as duas bibliotecas da mesma forma: instancia um mapeador/cliente e, depois, fornece um Java POJO às APIs que leem e gravam esses itens nas tabelas do DynamoDB. Ambas as bibliotecas também oferecem anotações para a classe do POJO para direcionar como o cliente lida com o POJO.

As principais diferenças quando você muda para a V2 incluem:

  • A V2 e a V1 usam nomes de métodos diferentes para as operações de baixo nível do DynamoDB. Por exemplo:

    V1 V2
    balanceamento getItem
    save putItem
    batchLoad batchGetItem

  • A V2 oferece várias maneiras de definir esquemas de tabela e mapear POJOs para tabelas. Você pode escolher entre o uso de anotações ou um esquema gerado a partir do código usando um compilador. A V2 também oferece versões mutáveis e imutáveis dos esquemas.

  • Com a V2, você cria especificamente o esquema da tabela como uma das primeiras etapas, enquanto na V1, o esquema da tabela é inferido da classe anotada conforme necessário.

  • A V2 inclui o cliente da API de documentos na API de cliente aprimorado, enquanto a V1 usa uma API separada.

  • Todas as APIs estão disponíveis nas versões síncrona e assíncrona na V2.

Consulte informações mais detalhadas sobre o cliente aprimorado da V2 na seção de mapeamento do DynamoDB deste guia.

Importar diferenças de dependência

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>

* Versão mais recente

Na V1, uma única dependência inclui a API de baixo nível do DynamoDB e a API de mapeamento/documento, enquanto na V2, você usa a dependência de artefato dynamodb-enhanced para acessar a API de mapeamento/documento. O módulo dynamodb-enhanced contém uma dependência transitiva do módulo de baixo níveldynamodb.