QLDBpilote Amazon pour Java

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

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.

Rubriques

• Ressources pour les conducteurs
• Prérequis
• Configuration de vos AWS informations d'identification par défaut et de votre région
• Installation
• Tutoriel de démarrage rapide
• Référence de livre de cuisine

Ressources pour les conducteurs

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

• APIréférence : 2.x, 1.x

• Code source du pilote (GitHub)

• Exemple de code source d'application (GitHub)

• Framework Ledger Loader () GitHub

• Exemples de code Amazon Ion

Prérequis

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

1. Suivez les instructions AWS de configuration indiquées dansAccès à Amazon QLDB. Cela inclut les éléments suivants :

   1. Inscrivez-vous pour AWS.

   2. Créez un utilisateur doté des QLDB autorisations appropriées.

   3. Accordez un accès programmatique pour le développement.

2. Configurez un environnement de développement Java en téléchargeant et en installant les éléments suivants :

   1. Kit de développement Java SE 8, tel qu'Amazon Corretto 8.

   2. (Facultatif) Environnement de développement intégré Java (IDE) de votre choix, tel qu'Eclipse ou IntelliJ.

3. Configurez votre environnement de développement pour le AWS SDK for Java byConfiguration de vos AWS informations d'identification par défaut et de votre région.

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

• Pour installer le QLDB pilote et le AWS SDK for Java dans un projet existant, passez àInstallation.

• Pour configurer un projet et exécuter des exemples de codes abrégés illustrant les transactions de données de base sur un registre, consultez leTutoriel de démarrage rapide.

• Pour obtenir des exemples plus détaillés d'APIopérations de gestion et de données dans l'exemple d'application complet du didacticiel, consultez leTutoriel Java.

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.

Versions du pilote	AWS SDK	Statut	Date de sortie la plus récente
1. x	AWS SDK for Java 1. x	Communiqué de production	20 mars 2020
2. x	AWS SDK for Java 2.x	Communiqué de production	4 juin 2021

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.

1. aws-java-sdk-qldb— Le QLDB module du AWS SDK for Java. La version minimale QLDB prise en charge est1.11.785.

   Utilisez ce module dans votre application pour interagir directement avec les API opérations de gestion répertoriées dans leQLDBAPIRéférence Amazon.

2. jackson-dataformat-ion— Le module XML de format de données Jackson de Faster pour Ion. L'exemple d'application nécessite une version 2.10.0 ou une version ultérieure.

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>