Controlador Amazon QLDB para Java - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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 unAWS-conductor proporcionado. En los siguientes temas se describe cómo comenzar a utilizar el controlador QLDB para Java.

Recursos de los controladores

Para obtener más información sobre la funcionalidad compatible con el controlador Java, consulte los siguientes recursos:

Requisitos previos

Para comenzar a utilizar el controlador QLDB para Java, debe hacer lo siguiente:

  1. Seguimiento de laAWSinstrucciones de configuración enAcceso a Amazon QLDB. Estas incluyen las siguientes:

    1. Registrarse enAWS.

    2. Creación de unAWS Identity and Access Management(IAM) con los permisos QLDB adecuados.

    3. Obtenga una clave de acceso de IAM para el desarrollo.

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

    1. Java SE Development Kit 8, comoAmazon Corretto 8.

    2. (Opcional) Entorno de desarrollo integrado (IDE) de Java de su elección, comoEclipseoIntelliJ.

  3. Configuración del entorno de desarrollo para elAWS SDK for JavaporAjuste de su valor predeterminadoAWScredenciales y región.

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

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

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

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

Ajuste de su valor predeterminadoAWScredenciales y región

El controlador QLDB y el subyacenteAWS SDK for Javarequiere que proporcionesAWScredenciales de su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se presupone que utiliza unAWSarchivo de credenciales, tal como se describe enEstablecer credenciales predeterminadas y regiónen laAWS SDK for Java 2.xGuía para desarrolladores.

Como parte de estos pasos, también debes establecer el valor predeterminadoAWSRegión para determinar el endpoint QLDB predeterminado. Los ejemplos de código se conectan a QLDB de forma predeterminadaAWSRegión . Para ver una lista completa de regiones de en las que QLDB está disponible, consulteCuotas y puntos de enlace de Amazon QLDBen laAWSReferencia general de.

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 la suya propiaAWSvalores de credenciales para los valoresyour_access_key_idyyour_secret_access_key.

Instalación

QLDB admite las siguientes versiones de controlador de Java y susAWSDependencias de SDK.

Versión de controlador AWS SDK Estado Fecha de la última versión
1.x AWS SDK for Java1.x Lanzamiento de producción 20 de marzo de 2020
2.x AWS SDK for Java 2.x Lanzamiento de producción 4 de junio de 2021

Para instalar el controlador QLDB, recomendamos utilizar un sistema de administración de dependencias, como Gradle o Maven. Por ejemplo, agregue el siguiente artefacto como dependencia de su proyecto Java.

2.x

Gradle

Agregue esta dependencia en subuild.gradleArchivo de configuración.

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

Maven

Agregue esta dependencia en supom.xmlArchivo 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 elAWS SDK for Java 2.xMódulo de núcleo,Amazon Ionbibliotecas y otras dependencias requeridas.

1.x

Gradle

Agregue esta dependencia en subuild.gradleArchivo de configuración.

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

Maven

Agregue esta dependencia en supom.xmlArchivo 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 elAWS SDK for JavaMódulo de núcleo,Amazon Ionbibliotecas y otras dependencias requeridas.

importante

Espacio de nombres de Amazon Ion— Al importar clases de Amazon Ion en su aplicación, debe utilizar el paquete que se encuentra bajo el espacio de nombrescom.amazon.ion. LaAWS SDK for Javadepende de otro paquete Ion en el espacio de nombressoftware.amazon.ion, pero se trata de un paquete heredado que no es compatible con el controlador QLDB.

Para obtener ejemplos breves de código sobre cómo ejecutar transacciones de datos básicos en un libro mayor, consulte laReferencia de los libros de recetas.

Otras librerías opcionales

Si lo desea, también puede agregar las siguientes bibliotecas útiles a su proyecto. Estos artefactos son dependencias obligatorias en elTutorial de JavaAplicación 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.

    Este módulo permite que la aplicación interactúe directamente con las operaciones de la API de administración enumeradas en elReferencia de la API de Amazon QLDB.

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

Gradle

Añada estas dependencias en subuild.gradleArchivo 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 en supom.xmlArchivo 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>