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.

pilote Amazon QLDB 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 fourni. AWS Les rubriques suivantes décrivent comment démarrer avec le pilote QLDB 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 pilote QLDB 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 pilote QLDB et le pilote AWS SDK for Javasous-jacent nécessitent 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 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 QLDB par défaut Région AWS pour déterminer votre point de terminaison QLDB par défaut. Les exemples de code se connectent à QLDB par défaut. Région AWS Pour obtenir la liste complète des régions dans lesquelles QLDB est disponible, consultez la section Points de terminaison et quotas Amazon QLDB 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 your_access_key_id et par vos propres AWS informations d'identificationyour_secret_access_key.

Installation

QLDB prend en charge les versions de pilotes Java suivantes et AWS leurs dépendances avec le SDK.

Pour installer le pilote QLDB, 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 situé sous l'espace de nomssoftware.amazon.ion, mais il s'agit d'un package existant qui n'est pas compatible avec le pilote QLDB.

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>