Exemplos de código Java

Este Guia do Desenvolvedor contém trechos de código Java e programas prontos para serem executados. Você encontrará esses exemplos de código nas seguintes seções:

• Trabalhar com itens e atributos

• Trabalhar com tabelas e dados no DynamoDB

• Operações de consulta no DynamoDB

• Trabalhar com verificações no DynamoDB

• Melhorar o acesso a dados com índices secundários

• Java 1.x: DynamoDBMapper

• Capturar dados de alterações para o DynamoDB Streams

É possível começar rapidamente usando o Eclipse com o AWS Toolkit for Eclipse. Além de um IDE completo, você também terá o AWS SDK for Java com atualizações automáticas e modelos pré-configurados para a compilação de aplicações da AWS.

Como executar os exemplos de código Java (usando o Eclipse)

1. Baixe e instale o IDE do Eclipse.

2. Faça download e instale o AWS Toolkit for Eclipse.

3. Inicie o Eclipse e, no menu Eclipse, escolha File (Arquivo), New (Novo) e Other (Outro).

4. Em Selecionar um assistente, escolha AWS, Projeto AWS Java e Próximo.

5. Em Criar um AWS Java, faça o seguinte:

   1. Em Nome do projeto, digite um nome para o projeto.

   2. Em Selecionar conta (Selecionar conta), escolha o perfil de suas credenciais na lista.

      Se essa for a primeira vez que você usa o AWS Toolkit for Eclipse, escolha Configurar contas da AWS para configurar suas credenciais da AWS.

6. Escolha Finish (Concluir) para criar o projeto.

7. No menu do Eclipse, escolha File (Arquivo), New (Novo) e, em seguida, Class (Classe).

8. Em Java Class (Classe Java), digite um nome para a sua classe em Name (Nome) (use o mesmo nome que o exemplo de código que você deseja executar) e escolha Finish (Concluir) para criar a classe.

9. Copie o exemplo de código da página de documentação no editor do Eclipse.

10. Para executar o código, escolha Run (Executar) no menu do Eclipse.

O SDK for Java fornece clientes thread-safe para trabalhar com o DynamoDB. De acordo com as melhores práticas, seus aplicativos devem criar um único cliente e reutilizá-lo entre os threads.

Para obter mais informações, consulte AWS SDK for Java.

nota

Os exemplos de código neste guia são destinados para uso com a versão mais recente do AWS SDK for Java.

Se estiver usando o AWS Toolkit for Eclipse, você poderá configurar atualizações automáticas para o SDK for Java. Para fazer isso no Eclipse, vá para Preferences (Preferências) e escolha AWS Toolkit, AWS SDK for Java e Download new SDKs automatically (Fazer download automático de novos SDKs).

Java: configurar suas credenciais da AWS

O SDK for Java exige que você forneça credenciais da AWS para a sua aplicação em tempo de execução. Os exemplos de código neste guia pressupõem que você esteja usando um arquivo de credenciais da AWS, conforme descrito em Configurar suas credenciais da AWS no Guia do desenvolvedor da AWS SDK for Java.

Veja a seguir um exemplo de um arquivo de credenciais da AWS chamado ~/.aws/credentials em que o caractere de til (~) representa seu diretório inicial.

[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here         

Java: configurar a região e o endpoint da AWS

Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar as propriedades AmazonDynamoDB.

O exemplo de código a seguir instancia uma nova AmazonDynamoDB.

import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();  

É possível usar o método withRegion para executar seu código no DynamoDB em qualquer região em que ele está disponível. Para obter uma lista completa, consulte Regiões e endpoints da AWS, na Referência geral da Amazon Web Services.

Se desejar executar os exemplos de código usando o DynamoDB localmente no seu computador, defina o endpoint conforme descrito a seguir.

AWS SDK V1

AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build(); 

AWS SDK V2

DynamoDbClient client = DynamoDbClient.builder()
    .endpointOverride(URI.create("http://localhost:8000"))
    // The region is meaningless for local DynamoDb but required for client builder validation
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
    AwsBasicCredentials.create("dummy-key", "dummy-secret")))
    .build();