

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exemples de code Java
<a name="CodeSamples.Java"></a>

**Topics**
+ [Java : Configuration de vos AWS informations d'identification](#CodeSamples.Java.Credentials)
+ [Java : définition de la AWS région et du point de terminaison](#CodeSamples.Java.RegionAndEndpoint)

Ce guide du développeur contient des extraits de code Java et ready-to-run des programmes. Vous pouvez trouver ces exemples de code dans les sections suivantes :
+ [Utilisation d’éléments et d’attributs dans DynamoDB](WorkingWithItems.md)
+ [Utilisation de tables et de données dans DynamoDB](WorkingWithTables.md)
+ [Interrogation de tables dans DynamoDB](Query.md)
+ [Analyse de tables dans DynamoDB](Scan.md)
+ [Amélioration de l’accès aux données avec les index secondaires dans DynamoDB](SecondaryIndexes.md)
+ [Java 1.x : Dynamo DBMapper](DynamoDBMapper.md)
+ [Modifier la récupération de données pour DynamoDB Streams](Streams.md)

Vous pouvez démarrer rapidement en utilisant Eclipse avec [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/). En plus d'un IDE complet, vous bénéficiez également de mises à jour automatiques et de modèles préconfigurés pour créer AWS des applications. AWS SDK pour Java 

**Pour exécuter les exemples de code Java (à l’aide d’Eclipse)**

1. Téléchargez et installez l’IDE [Eclipse](http://www.eclipse.org).

1. Téléchargez et installez le kit [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/).

1. Démarrez Eclipse et, dans le menu **Eclipse**, choisissez **File (Fichier)**, **New (Nouveau)**, puis **Other (Autre)**.

1. Dans **Sélectionner un assistant**, choisissez successivement **AWS**, **AWS Projet Java** et **Suivant**.

1. Dans **Create an AWS Java**, procédez comme suit :

   1. Dans **Project name (Nom de projet)**, saisissez un nom pour votre projet.

   1. Dans **Select Account**, choisissez votre profil d’informations d’identification dans la liste.

      Si c'est la première fois que vous utilisez le [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/), choisissez **Configurer les AWS comptes** pour configurer vos AWS informations d'identification.

1. Choisissez **Finish** pour créer le projet.

1. Dans le menu **Eclipse**, choisissez **File**, **New**, puis **Class**.

1. Dans **Java Class (Classe Java)**, saisissez un nom pour votre classe dans **Name (Nom)** (utilisez le même nom que celui de l’exemple de code que vous souhaitez exécuter), puis choisissez **Finish (Terminer)** pour créer la classe.

1. Copiez l’exemple de code de la page de documentation dans l’éditeur Eclipse.

1. Pour exécuter le code, choisissez **Run (Exécuter)** dans le menu Eclipse.

Le kit SDK pour Java fournit des clients thread-safe à utiliser avec DynamoDB. En tant que bonne pratique, vos applications doivent créer un seul client et le réutiliser entre les threads.

Pour de plus amples informations, veuillez consulter [AWS SDK pour Java](https://aws.amazon.com/sdk-for-java).

**Note**  
Les exemples de code dans ce guide sont destinés à être utilisés avec la dernière version de AWS SDK pour Java.  
Si vous utilisez le AWS Toolkit for Eclipse, vous pouvez configurer des mises à jour automatiques pour le SDK for Java. Pour ce faire, dans Eclipse, allez dans **Préférences** et choisissez **AWS Toolkit**« **Télécharger le nouveau SDKs automatiquement** ». **AWS SDK pour Java**

## Java : Configuration de vos AWS informations d'identification
<a name="CodeSamples.Java.Credentials"></a>

Le SDK for Java nécessite que vous AWS fournissiez des informations d'identification à votre application lors de l'exécution. Les exemples de code présentés dans ce guide supposent que vous utilisez un fichier d' AWS informations d'identification, comme décrit dans la section [Configurer vos AWS informations d'identification](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/set-up-creds.html) dans le *guide du AWS SDK pour Java développeur*.

Voici un exemple de fichier d' AWS informations d'identification nommé`~/.aws/credentials`, où le caractère tilde (`~`) représente votre répertoire personnel.

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

## Java : définition de la AWS région et du point de terminaison
<a name="CodeSamples.Java.RegionAndEndpoint"></a>

Par défaut, les exemples de code accèdent à DynamoDB dans la région USA Ouest (Oregon). Vous pouvez modifier la région en modifiant les propriétés `AmazonDynamoDB`.

L’exemple de code suivant instancie un nouvel `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();
```

Vous pouvez utiliser la méthode `withRegion` pour exécuter votre code sur DynamoDB dans n’importe quelle région où il est disponible. Pour obtenir la liste complète, consultez [Régions et points de terminaison AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) dans le *Référence générale d'Amazon Web Services*.

Si vous souhaitez exécuter les exemples de code à l’aide de DynamoDB localement sur votre ordinateur, définissez le point de terminaison comme suit.

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