Driver QLDB Amazon untuk Java - Amazon Quantum Ledger Database (Amazon QLDB)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Driver QLDB Amazon untuk Java

Untuk bekerja dengan data dalam buku besar Anda, Anda dapat terhubung ke Amazon QLDB dari aplikasi Java Anda dengan menggunakan driver yangAWS disediakan. Topik berikut menjelaskan cara untuk memulai dengan driver QLDB untuk Java.

Sumber daya driver

Untuk informasi selengkapnya tentang fungsionalitas yang didukung oleh driver Java, lihat sumber daya berikut:

Prasyarat

Sebelum Anda memulai dengan driver QLDB untuk Java, Anda harus melakukan hal berikut:

  1. Ikuti petunjukAWS pengaturan diMengakses Amazon QLDB. Hal ini termasuk skenario berikut:

    1. Daftar ke AWS.

    2. Buat pengguna dengan izin QLDB yang sesuai.

    3. Memberikan akses terprogram untuk pengembangan.

  2. Siapkan lingkungan pengembangan Java dengan mengunduh dan menginstal yang berikut ini:

    1. Java SE Development Kit 8, seperti Amazon Corretto 8.

    2. (Opsional) Java integrated development environment (IDE) pilihan Anda, seperti Eclipse atau IntelliJ.

  3. Konfigurasikan lingkungan pengembangan Anda untukAWS SDK for Java byMengaturAWS kredensi dan Wilayah default.

Selanjutnya, Anda dapat mengunduh aplikasi contoh tutorial lengkap—atau Anda hanya dapat menginstal driver dalam proyek Java dan menjalankan contoh kode pendek.

  • Untuk menginstal driver QLDB danAWS SDK for Java dalam proyek yang ada, lanjutkan keInstalasi.

  • Untuk menyiapkan proyek dan menjalankan contoh kode pendek yang menunjukkan transaksi data dasar pada buku besar, lihatTutorial Quick Start.

  • Untuk menjalankan contoh yang lebih mendalam dari kedua data dan operasi API manajemen dalam aplikasi sampel tutorial lengkap, lihattutorial java.

MengaturAWS kredensi dan Wilayah default

Driver QLDB dan yang mendasari AWS SDK for Javamengharuskan Anda memberikanAWS kredensi untuk aplikasi Anda pada saat runtime. Contoh kode dalam panduan ini menganggap bahwa Anda menggunakan fileAWS kredensi, seperti yang dijelaskan dalam Menyiapkan kredensi dan Wilayah default dalam PanduanAWS SDK for Java 2.x Developer.

Sebagai bagian dari langkah-langkah ini, Anda juga harus mengatur default AndaWilayah AWS untuk menentukan endpoint QLDB default Anda. Contoh kode terhubung ke QLDB di default AndaWilayah AWS. Untuk daftar lengkap Wilayah tempat QLDB tersedia, lihat titik akhir dan kuota Amazon QLDB di bagian Referensi Umum AWS.

Berikut ini adalah contoh file kredensial AWS bernama ~/.aws/credentials, di mana karakter tilde (~) mewakili direktori beranda Anda.

[default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key

Ganti nilaiAWS kredensi Anda sendiri untuk nilai your_key_key_key_key_key_key_secret_access_key_key_key_key_key_key_key_key_key_key_key_key_key_key_key_

Instalasi

QLDB mendukung versi driver Java berikut dan dependensiAWS SDK mereka.

Versi driver AWS SDK Status Tanggal rilis terbaru
1.x AWS SDK for Java1.x Rilis produksi 20 Maret 2020
2.x AWS SDK for Java 2.x Rilis produksi 4 Juni 2021

Untuk menginstal driver QLDB, sebaiknya gunakan sistem manajemen dependensi, seperti Gradle atau Maven. Misalnya, tambahkan artefak berikut sebagai dependensi dalam proyek Java Anda.

2.x

Gradle

Tambahkan dependensi ini di filebuild.gradle konfigurasi Anda.

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

Maven

Tambahkan dependensi ini di filepom.xml konfigurasi Anda.

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

Artefak ini secara otomatis menyertakan modulAWS SDK for Java 2.x inti, pustaka Amazon Ion, dan dependensi lain yang diperlukan.

1.x

Gradle

Tambahkan dependensi ini di filebuild.gradle konfigurasi Anda.

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

Maven

Tambahkan dependensi ini di filepom.xml konfigurasi Anda.

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

Artefak ini secara otomatis menyertakan modulAWS SDK for Java inti, pustaka Amazon Ion, dan dependensi lain yang diperlukan.

penting

Namespace Amazon Ion — Saat mengimpor kelas Amazon Ion di aplikasi Anda, Anda harus menggunakan paket yang berada di bawah namespacecom.amazon.ion. AWS SDK for JavaTergantung pada paket Ion lain di bawah namespacesoftware.amazon.ion, tetapi ini adalah paket lama yang tidak kompatibel dengan driver QLDB.

Untuk contoh kode singkat tentang cara menjalankan transaksi data dasar pada buku besar, lihatReferensi buku masak.

Pustaka opsional lainnya

Anda juga dapat menambahkan library berguna berikut dalam proyek Anda. Artefak ini diperlukan dependensi dalam aplikasitutorial java sampel.

  1. aws-java-sdk-qldb- Modul QLDB dariAWS SDK for Java. Versi minimum yang didukung QLDB adalah1.11.785.

    Gunakan modul ini di aplikasi Anda untuk berinteraksi langsung dengan operasi API manajemen yang tercantum dalam aplikasiReferensi API Amazon QLDB.

  2. jackson-dataformat-ion- Modul format data Jackson FasterXML's untuk Ion. Aplikasi sampel membutuhkan versi2.10.0 atau yang lebih baru.

Gradle

Tambahkan dependensi ini di filebuild.gradle konfigurasi Anda.

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

Tambahkan dependensi ini di filepom.xml konfigurasi Anda.

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