Driver Amazon QLDB per Java

Per lavorare con i dati contenuti nel tuo registro, puoi connetterti ad Amazon QLDB dalla tua applicazione Java utilizzando un driverAWS fornito. I seguenti argomenti descrivono come iniziare a usare il driver QLDB per Java.

Argomenti

• Risorse per i conducenti
• Prerequisiti
• Impostazione delleAWS credenziali e della regione predefinite
• Installazione
• Guida di avvio rapido
• Documentazione di riferimento del libro

Risorse per i conducenti

Per ulteriori informazioni sulle funzionalità supportate dal driver Java, vedere le risorse seguenti:

• Riferimento API: 2.x, 1.x

• Codice sorgente del driver (GitHub)

• Codice sorgente dell'applicazione di esempio (GitHub)

• Struttura Ledger Loader (GitHub)

• Esempi di codice Amazon Ion

Prerequisiti

Prima di iniziare a utilizzare il driver QLDB per Java, occorre:

1. Segui le istruzioniAWS di configurazione inAccesso ad Amazon QLDB. Questo include gli output seguenti:

   1. Per registrarti e ottenere un accountAWS.

   2. Crea un utente con le autorizzazioni QLDB appropriate.

   3. Concessione dell'accesso programmatico per lo sviluppo.

2. Configura un ambiente di sviluppo Java scaricando e installando quanto segue:

   1. Java SE Development Kit 8, ad esempio Amazon Corretto 8.

   2. (Facoltativo) Ambiente di sviluppo integrato Java (IDE) di tua scelta, come Eclipse o IntelliJ.

3. Configura subito il tuo ambienteAWS SDK for Java di sviluppoImpostazione delleAWS credenziali e della regione predefinite.

Successivamente, puoi scaricare l'applicazione di esempio del tutorial completo oppure puoi installare solo il driver in un progetto Java ed eseguire brevi esempi di codice.

• Per installare il driver QLDB e il driverAWS SDK for Java in un progetto esistente, procedere aInstallazione.

• Per configurare un progetto ed eseguire brevi esempi di codice che dimostrino le transazioni di dati di base su un libro mastro, consulta ilGuida di avvio rapido.

• Per eseguire esempi più approfonditi di operazioni relative ai dati e alle API di gestione nell'applicazione di esempio del tutorial completo, consulta ilTutorial su Java.

Impostazione delleAWS credenziali e della regione predefinite

Il driver QLDB e il sottostante driver AWS SDK for Javarichiedono che siano forniteAWS le credenziali all'applicazione durante il runtime. Gli esempi di codice in questa guida presuppongono che stia usando un file diAWS credenziali, come descritto in Configurazione delle credenziali e della regione predefinite nella Guida per gliAWS SDK for Java 2.x sviluppatori di.

Come parte di questi passaggi, è necessario impostare anche il valore predefinitoRegione AWS per determinare l'endpoint QLDB predefinito. Gli esempi di codice si connettono a QLDB come impostazione predefinitaRegione AWS. Per un elenco completo delle regioni in cui QLDB è disponibile, consulta gli endpoint e le quote di Amazon QLDB nella Riferimenti generali di AWS.

Di seguito, è riportato un esempio di un file di credenziali AWS, denominato ~/.aws/credentials, dove il segno della tilde (~) rappresenta la tua directory home.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Sostituisci i valoriAWS delle tue credenziali con i valori your_access_key_id e your_secret_access_key.

Installazione

QLDB supporta le seguenti versioni dei driver Java e le relative dipendenzeAWS SDK.

Versione driver	AWS SDK	Stato	Data di rilascio più recente
1.x	AWS SDK for Java1.x	Versione di produzione	20 marzo 2020
2.x	AWS SDK for Java 2.x	Versione di produzione	4 giugno 2021

Per installare il driver QLDB, si consiglia di utilizzare un sistema di gestione delle dipendenze, come Gradle o Maven. Ad esempio, aggiungi il seguente artefatto come dipendenza nel proprio progetto Java.

2.x

Gradle

Aggiungi questa dipendenza nel tuo filebuild.gradle di configurazione.

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

Maven

Aggiungi questa dipendenza nel tuo filepom.xml di configurazione.

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

Questo artefatto include automaticamente il moduloAWS SDK for Java 2.x principale, le librerie Amazon Ion e altre dipendenze richieste.

1.x

Gradle

Aggiungi questa dipendenza nel tuo filebuild.gradle di configurazione.

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

Maven

Aggiungi questa dipendenza nel tuo filepom.xml di configurazione.

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

Questo artefatto include automaticamente il moduloAWS SDK for Java principale, le librerie Amazon Ion e altre dipendenze richieste.

Importante

Spazio dei nomi Amazon Ion: quando si importano le classi Amazon Ion nell'applicazione, è necessario utilizzare il pacchetto che si trova sotto lo spazio dei nomicom.amazon.ion. AWS SDK for JavaDipende da un altro pacchetto Ion nel namespacesoftware.amazon.ion, ma questo è un pacchetto legacy che non è compatibile con il driver QLDB.

Per brevi esempi di codice su come eseguire transazioni di dati di base su un libro mastro, vedere ilDocumentazione di riferimento del libro.

Altre librerie opzionali

Eventualmente, è anche possibile aggiungere le seguenti librerie utili al proprio progetto. Questi artefatti sono dipendenze obbligatorie nell'applicazioneTutorial su Java di esempio.

1. aws-java-sdk-qldb— Il modulo QLDB delAWS SDK for Java. La versione minima supportata da QLDB è1.11.785.

   Utilizza questo modulo nella tua applicazione per interagire direttamente con le operazioni dell'API di gestione elencate inDocumentazione di riferimento dell'API Amazon QLDB.

2. jackson-dataformat-ion— Modulo di formato dati Jackson di FasterXML per Ion. L'applicazione di esempio richiede una versione2.10.0 o successiva.

Gradle

Aggiungi queste dipendenze nel tuo filebuild.gradle di configurazione.

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

Aggiungi queste dipendenze nel tuo filepom.xml di configurazione.

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