Exemples de code Java - Amazon DynamoDB

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

Ce Guide du développeur contient des extraits de code Java et des programmes prêts à être exécutés. Vous pouvez trouver ces exemples de code dans les sections suivantes :

Vous pouvez démarrer rapidement en utilisant Eclipse avec AWS Toolkit for Eclipse. En plus d'un IDE complet, vous obtenez aussi l'AWS SDK for Java avec les mises à jour automatiques, ainsi que des modèles préconfigurés pour la génération d'applications AWS.

Pour exécuter les exemples de code Java (à l'aide d'Eclipse)
  1. Téléchargez et installez l'IDE Eclipse.

  2. Téléchargez et installez le kit AWS Toolkit for Eclipse.

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

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

  5. Dans Créer une Java AWS, procédez comme suit :

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

    2. Dans Select Account, choisissez votre profil d'informations d'identification dans la liste.

      S'il s'agit de votre première utilisation de AWS Toolkit for Eclipse, choisissez Configurer des comptes AWS pour configurer vos informations d'identification AWS.

  6. Choisissez Finish pour créer le projet.

  7. Dans le menu Eclipse, choisissez File, New, puis Class.

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

  9. Copiez l'exemple de code de la page de documentation dans l'éditeur Eclipse.

  10. 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 plus d'informations, consultez le AWS 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 for Java.

Si vous utilisez l'AWS Toolkit for Eclipse, vous pouvez configurer des mises à jour automatiques pour le kit SDK pour Java. Pour ce faire dans Eclipse, accédez à Preferences (Préférences) et choisissez successivement AWS Toolkit, AWS SDK for Java, Download new SDKs automatically (Télécharger les nouveaux kits SDK automatiquement).

Java : définition de vos informations d'identification AWS

Le kit (SDK) nécessite que vous fournissiez des informations d'identification AWS à votre application lors de l'exécution. Les exemples de code dans ce guide partent du principe que vous utilisez un fichier d'informations d'identification AWS, comme décrit dans la section Configuration de vos informations d'identification AWS du Guide du développeur AWS SDK for Java.

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

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

Java : définition de la région AWS et du point de terminaison

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

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

Kit SDK AWS V1

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

Kit SDK AWS 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();