# Exemplos de código Java
<a name="CodeSamples.Java"></a>

**Topics**
+ [Java: configurar suas credenciais da AWS](#CodeSamples.Java.Credentials)
+ [Java: configurar a região e o endpoint da AWS](#CodeSamples.Java.RegionAndEndpoint)

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 no DynamoDB](WorkingWithItems.md)
+ [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md)
+ [Consultar tabelas no DynamoDB](Query.md)
+ [Verificar tabelas no DynamoDB](Scan.md)
+ [Melhorar o acesso aos dados com índices secundários no DynamoDB](SecondaryIndexes.md)
+ [Java 1.x: DynamoDBMapper](DynamoDBMapper.md)
+ [Capturar dados de alterações para o DynamoDB Streams](Streams.md)

É possível começar rapidamente usando o Eclipse com o [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/). Além de um IDE completo, você também terá o AWS SDK para 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](http://www.eclipse.org).

1. Baixe e instale a [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/).

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

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

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

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

   1. 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](https://aws.amazon.com/eclipse/), escolha **Configurar contas da AWS** para configurar suas credenciais da AWS.

1. Escolha **Finish (Concluir)** para criar o projeto.

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

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

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

1. 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 a [AWS SDK para Java](https://aws.amazon.com/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 para 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 para Java** e **Download new SDKs automatically** (Fazer download automático de novos SDKs).

## Java: configurar suas credenciais da AWS
<a name="CodeSamples.Java.Credentials"></a>

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](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/set-up-creds.html) no *Guia do desenvolvedor da AWS SDK para 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
<a name="CodeSamples.Java.RegionAndEndpoint"></a>

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 software.amazon.dynamodb.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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region), 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
<a name="CodeSamples.Java.RegionAndEndpoint.V1"></a>

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

### AWS SDK V2
<a name="CodeSamples.Java.RegionAndEndpoint.V2"></a>

```
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();
```