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.

QLDBpilote Amazon pour Java

Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre application Java à l'aide d'un pilote AWS fourni. Les rubriques suivantes décrivent comment démarrer avec le QLDB pilote pour Java.

Ressources pour les conducteurs

Pour plus d'informations sur les fonctionnalités prises en charge par le pilote Java, consultez les ressources suivantes :

Prérequis

Avant de commencer à utiliser le QLDB pilote pour Java, vous devez effectuer les opérations suivantes :

Ensuite, vous pouvez télécharger l'exemple complet du didacticiel, ou vous pouvez installer uniquement le pilote dans un projet Java et exécuter des exemples de code abrégé.

Configuration de vos AWS informations d'identification par défaut et de votre région

Le QLDB pilote et le sous-jacent AWS SDK for Javanécessitent que vous fournissiez des AWS 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 Définir les informations d'identification par défaut et la région dans le guide du AWS SDK for Java 2.x développeur.

Dans le cadre de ces étapes, vous devez également définir votre point de terminaison par défaut Région AWS pour déterminer votre point de QLDB terminaison par défaut. Les exemples de code se connectent QLDB à votre code par défaut Région AWS. Pour une liste complète des régions où cette option QLDB est disponible, consultez la section QLDBPoints de terminaison et quotas Amazon dans le Références générales AWS.

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 = your_access_key_id
aws_secret_access_key = your_secret_access_key

Remplacez les valeurs de vos propres AWS informations d'identification par les valeurs your_access_key_id and your_secret_access_key.

Installation

QLDBprend en charge les versions de pilotes Java suivantes et leurs AWS SDK dépendances.

Pour installer le QLDB pilote, nous vous recommandons d'utiliser un système de gestion des dépendances tel que Gradle ou Maven. Par exemple, ajoutez l'artefact suivant en tant que dépendance dans votre projet Java.

2.x

Gradle

Ajoutez cette dépendance dans votre fichier build.gradle de configuration.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '2.3.1'
}

Maven

Ajoutez cette dépendance dans votre fichier pom.xml de configuration.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>2.3.1</version>
  </dependency>
</dependencies>

Cet artefact inclut automatiquement le module AWS SDK for Java 2.x principal, les bibliothèques Amazon Ion et les autres dépendances requises.

1.x

Gradle

Ajoutez cette dépendance dans votre fichier build.gradle de configuration.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0'
}

Maven

Ajoutez cette dépendance dans votre fichier pom.xml de configuration.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

Cet artefact inclut automatiquement le module AWS SDK for Java principal, les bibliothèques Amazon Ion et les autres dépendances requises.

Important

Espace de noms Amazon Ion : lorsque vous importez des classes Amazon Ion dans votre application, vous devez utiliser le package situé sous l'espace de nomscom.amazon.ion. AWS SDK for Java Cela dépend d'un autre package Ion sous l'espace de nomssoftware.amazon.ion, mais il s'agit d'un package existant qui n'est pas compatible avec le QLDB pilote.

Pour des exemples de code abrégé expliquant comment exécuter des transactions de données de base sur un registre, consultez leRéférence de livre de cuisine.

Autres bibliothèques facultatives

Vous pouvez éventuellement ajouter les bibliothèques utiles suivantes dans votre projet. Ces artefacts sont des dépendances obligatoires dans l'Tutoriel Javaexemple d'application.

Gradle

Ajoutez ces dépendances dans votre fichier build.gradle de configuration.

dependencies {
    compile group: 'com.amazonaws', name: 'aws-java-sdk-qldb', version: '1.11.785'
    compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-ion', version: '2.10.0'
}

Maven

Ajoutez ces dépendances dans votre fichier pom.xml de configuration.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-qldb</artifactId>
    <version>1.11.785</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-ion</artifactId>
    <version>2.10.0</version>
  </dependency>
</dependencies>