As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

QLDBDriver Amazon para Java

Para trabalhar com dados em seu livro contábil, você pode se conectar à Amazon a QLDB partir do seu aplicativo Java usando um driver AWS fornecido. Os tópicos a seguir descrevem como começar a usar o QLDB driver para Java.

Recursos para driver

Para obter mais informações sobre a funcionalidade suportada pelo driver Java, consulte os recursos a seguir:

Pré-requisitos

Antes de começar a usar o QLDB driver para Java, você deve fazer o seguinte:

Em seguida, você pode baixar o aplicativo completo de amostra do tutorial ou instalar somente o driver em um projeto Java e executar exemplos de códigos curtos.

Como credenciar suas credenciais AWS e região padrão

O QLDB driver e o subjacente AWS SDK for Javaexigem que você forneça AWS credenciais ao seu aplicativo em tempo de execução. Os exemplos de código neste guia pressupõem que você esteja usando um arquivo de credenciais AWS , conforme descrito em Configurar credenciais e região padrão no Guia do desenvolvedor do AWS SDK for Java 2.x .

Como parte dessas etapas, você também deve definir seu padrão Região da AWS para determinar seu QLDB endpoint padrão. Os exemplos de código se conectam ao QLDB seu padrão Região da AWS. Para obter uma lista completa das regiões onde QLDB está disponível, consulte QLDBendpoints e cotas da Amazon no. Referência geral da AWS

Veja a seguir um exemplo de um arquivo de AWS credenciais chamado~/.aws/credentials, em que o caractere tilde (~) representa seu diretório inicial.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Substitua seus próprios valores AWS de credenciais pelos valores your_access_key_id e your_secret_access_key.

Instalação

QLDBsuporta as seguintes versões do driver Java e suas AWS SDK dependências.

Para instalar o QLDB driver, recomendamos usar um sistema de gerenciamento de dependências, como o Gradle ou o Maven. Por exemplo, adicione o artefato a seguir como uma dependência no seu projeto Java.

2.x

Gradle

Adicione essa dependência ao seu arquivo build.gradle de configuração.

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

Maven

Adicione essa dependência ao seu arquivo pom.xml de configuração.

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

Esse artefato inclui automaticamente o módulo AWS SDK for Java 2.x principal, as bibliotecas Amazon Ion e outras dependências necessárias.

1.x

Gradle

Adicione essa dependência ao seu arquivo build.gradle de configuração.

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

Maven

Adicione essa dependência ao seu arquivo pom.xml de configuração.

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

Esse artefato inclui automaticamente o módulo AWS SDK for Java principal, as bibliotecas Amazon Ion e outras dependências necessárias.

Importante

Namespace Amazon Ion: ao importar classes Amazon Ion em seu aplicativo, você deve usar o pacote que está sob o namespacecom.amazon.ion. AWS SDK for Java Depende de outro pacote Ion no namespacesoftware.amazon.ion, mas esse é um pacote legado que não é compatível com o QLDB driver.

Para exemplos de código curto de como executar transações básicas de dados em um ledger, consulte o Referência de Cookbook.

Outras bibliotecas opcionais

Como opção, adicione também as seguintes bibliotecas úteis ao seu projeto. Esses artefatos são dependências obrigatórias no aplicativo Tutorial de Java de amostra.

Gradle

Adicione essas dependências ao seu arquivo de configuração build.gradle.

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

Adicione essas dependências ao seu arquivo de configuração pom.xml.

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