Controlador Amazon QLDB para Java

Para trabajar con los datos de su libro mayor, puede conectarse a Amazon QLDB desde su aplicación Java mediante el controladorAWS proporcionado. En los temas siguientes, se describe cómo empezar a usar el controlador QLDB para Java.

Temas

• Recursos para conductores
• Requisitos previos
• Configuración de susAWS credenciales y región predeterminadas
• Instalación
• Tutorial de inicio
• Referencia del libro de cocina

Recursos para conductores

Para obtener más información sobre las funciones que admite el controlador Java, consulte los siguientes recursos:

• Referencia de API: 2.x, 1.x

• Código fuente del controlador (GitHub)

• Ejemplo de código fuente de la aplicación (GitHub)

• Framework de Ledger Loader (GitHub)

• Ejemplos de código de Amazon Ion

Requisitos previos

Antes de empezar con el controlador QLDB para Java, debe hacer lo siguiente:

1. Siga las instruccionesAWS de configuración que aparecen enAcceso a Amazon QLDB. Estas incluyen las siguientes:

   1. Registrarse enAWS.

   2. Cree un usuario con los permisos de QLDB adecuados.

   3. Conceder acceso programático para el desarrollo.

2. Configure un entorno de desarrollo de Java descargando e instalando lo siguiente:

   1. Kit de desarrollo de Java SE 8, como Amazon Corretto 8.

   2. (Opcional) Entorno de desarrollo integrado (IDE) de Java de su elección, como Eclipse o IntelliJ.

3. Configure su entorno de desarrollo paraAWS SDK for Java el niñoConfiguración de susAWS credenciales y región predeterminadas.

A continuación, puede descargar la aplicación de muestra completa del tutorial o puede instalar solo el controlador en un proyecto de Java y ejecutar ejemplos de código cortos.

• Para instalar el controlador QLDB y elAWS SDK for Java en un proyecto existente, proceda aInstalación.

• Para configurar un proyecto y ejecutar ejemplos de código cortos que demuestren las transacciones de datos básicas en un libro mayor, consulte laTutorial de inicio.

• Para ver ejemplos más detallados de las operaciones de la API de administración y de datos en la aplicación de ejemplo completa del tutorial, consulte laTutorial de Java.

Configuración de susAWS credenciales y región predeterminadas

El controlador QLDB y el controlador subyacente AWS SDK for Javarequieren que proporcioneAWS las credenciales de a su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa un archivo deAWS credenciales de, tal como se describe en Establecer las credenciales y la región predeterminados en la Guía paraAWS SDK for Java 2.x desarrolladores de.

Como parte de estos pasos, también debe establecer su valor predeterminadoRegión de AWS para determinar su punto final de QLDB predeterminado. Los ejemplos de código se conectan a QLDB de forma predeterminadaRegión de AWS. Para obtener una lista completa de las regiones en las que está disponible QLDB, consulte los puntos de conexión y cuotas de Amazon QLDB en el Referencia general de AWS.

A continuación se muestra un ejemplo de archivo de credenciales de AWS denominado ~/.aws/credentials, donde el carácter de tilde (~) representa su directorio de inicio.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Sustituya sus propios valores deAWS credenciales por los valores your_access_key_id y your_secret_access_key.

Instalación

QLDB admite las siguientes versiones de controladores de Java y sus dependencias delAWS SDK.

Versión de controlador	SDK de AWS	Estado	Fecha de versiones más reciente
1.x	AWS SDK for Java1.x	Versión de producción	20 de marzo de 2020
2.x	AWS SDK for Java 2.x	Versión de producción	4 de junio de 2021

Para instalar el controlador QLDB, se recomienda utilizar un sistema de administración de dependencias, como Gradle o Maven. Por ejemplo, añada el siguiente artefacto como una dependencia en su proyecto Java.

2.x

Gradle

Añada esta dependencia al archivobuild.gradle de configuración.

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

Maven

Añada esta dependencia al archivopom.xml de configuración.

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

Este artefacto incluye automáticamente el móduloAWS SDK for Java 2.x principal, las bibliotecas de Amazon Ion y otras dependencias necesarias.

1.x

Gradle

Añada esta dependencia al archivobuild.gradle de configuración.

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

Maven

Añada esta dependencia al archivopom.xml de configuración.

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

Este artefacto incluye automáticamente el móduloAWS SDK for Java principal, las bibliotecas de Amazon Ion y otras dependencias necesarias.

importante

Espacio de nombres Amazon Ion: al importar clases de Amazon Ion a su aplicación, debe utilizar el paquete que se encuentra en el espacio de nombrescom.amazon.ion. AWS SDK for JavaDepende de otro paquete de Ion en el espacio de nombressoftware.amazon.ion, pero se trata de un paquete antiguo que no es compatible con el controlador QLDB.

Para ver ejemplos breves de código sobre cómo ejecutar transacciones de datos básicas en un libro mayor, consulte laReferencia del libro de cocina.

Otras bibliotecas opcionales

Si lo desea, también puede agregar las siguientes bibliotecas útiles en el proyecto. Estos artefactos son dependencias obligatorias en la aplicaciónTutorial de Java de ejemplo.

1. aws-java-sdk-qldb— El módulo QLDB delAWS SDK for Java. La versión mínima compatible con QLDB es1.11.785.

   Utilice este módulo de su aplicación para interactuar directamente con las operaciones de la API de administración que figuran enReferencia de la API de Amazon QLDB.

2. jackson-dataformat-ion— Módulo de formato de datos Jackson de FasterXML para Ion. La aplicación de ejemplo requiere una versión2.10.0 o posterior.

Gradle

Añada estas dependencias al archivobuild.gradle de configuración.

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

Añada estas dependencias al archivopom.xml de configuración.

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