Mudanças de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK for Java - AWS SDK for Java 2.x

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á.

Mudanças de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK for Java

Os nomes do cliente de mapeamento em cada biblioteca diferem em V1 e V2:

  • V1 - Dínamo DBMapper

  • V2 - Cliente aprimorado do DynamoDB

Você interage com as duas bibliotecas da mesma forma: instancia uma mapper/client e, em seguida, fornece um Java POJO para APIs essa leitura e gravação desses 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 diferenças notáveis 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 POJOs mapear para tabelas. Você pode escolher entre o uso de anotações ou um esquema gerado a partir do código usando um construtor. 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 Document API na API de cliente aprimorada, enquanto a V1 usa uma API separada.

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

Consulte a seção de mapeamento do DynamoDB neste guia para obter informações mais detalhadas sobre o cliente aprimorado V2.

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 tanto a API de baixo nível do DynamoDB quanto a API, enquanto na V2, você usa mapping/document dynamodb-enhanced a dependência do artefato para acessar a API. mapping/document O dynamodb-enhanced módulo contém uma dependência transitiva do módulo de baixo níveldynamodb.