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:
É possível começar rapidamente usando o Eclipse com o AWS Toolkit for Eclipse
Como executar os exemplos de código Java (usando o Eclipse)
-
Baixe e instale o IDE do Eclipse
. -
Faça download e instale o AWS Toolkit for Eclipse
. -
Inicie o Eclipse e, no menu Eclipse, escolha File (Arquivo), New (Novo) e Other (Outro).
-
Em Selecionar um assistente, escolha AWS, Projeto AWS Java e Próximo.
-
Em Criar um AWS Java, faça o seguinte:
-
Em Nome do projeto, digite um nome para o seu projeto.
-
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.
-
-
Escolha Finish (Concluir) para criar o projeto.
-
No menu do Eclipse, escolha File (Arquivo), New (Novo) e, em seguida, Class (Classe).
-
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.
-
Copie o exemplo de código da página de documentação no editor do Eclipse.
-
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();