Menggunakan AWS SDK for Java - Amazon Simple Storage Service
Organisasi API JavaMenguji Contoh Kode Java Amazon S3

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

Menggunakan AWS SDK for Java

AWS SDK for Java Ini menyediakan API untuk bucket Amazon S3 dan operasi objek. Untuk operasi objek, selain menyediakan API untuk mengunggah objek dalam satu operasi, SDK menyediakan API untuk mengunggah objek besar dalam beberapa bagian. Untuk informasi selengkapnya, lihat Mengunggah dan menyalin objek menggunakan unggahan multibagian.

AWS SDK for Java Ini memberi Anda opsi untuk menggunakan API tingkat tinggi atau tingkat rendah.

API Tingkat Rendah

API tingkat rendah sesuai dengan operasi REST Amazon S3 yang mendasarinya, seperti operasi buat, perbarui, dan hapus yang berlaku untuk bucket dan objek. Saat Anda mengunggah objek besar menggunakan API pengunggahan multibagian tingkat rendah, API ini memberikan kontrol yang lebih besar. Misalnya, Anda dapat menjeda dan melanjutkan unggahan multibagian, mengubah ukuran bagian selama pengunggahan, atau memulai pengunggahan saat Anda tidak mengetahui ukuran data sebelumnya. Jika Anda tidak memiliki persyaratan ini, gunakan API tingkat tinggi untuk mengunggah objek.

API Tingkat Tinggi

Untuk mengunggah objek, SDK memberikan tingkat abstraksi yang lebih tinggi dengan menyediakan kelas TransferManager. API tingkat tinggi adalah API yang lebih sederhana, yaitu hanya dengan beberapa baris kode, Anda dapat mengunggah file dan streaming ke Amazon S3. Anda harus menggunakan API ini untuk mengunggah data, kecuali jika Anda perlu mengontrol pengunggahan sebagaimana dijelaskan di bagian API Tingkat Rendah sebelumnya.

Untuk ukuran data yang lebih kecil, API TransferManager mengunggah data dalam satu operasi. Namun, TransferManager akan beralih menggunakan API pengunggahan multibagian saat ukuran data mencapai ambang tertentu. Jika memungkinkan, TransferManager menggunakan beberapa utas untuk mengunggah komponen secara bersamaan. Jika pengunggahan suatu bagian gagal, API akan mengulang pengunggahan bagian yang gagal hingga tiga kali. Namun, ini adalah opsi yang dapat dikonfigurasi menggunakan kelas TransferManagerConfiguration.

catatan

Saat Anda menggunakan stream untuk sumber data, kelas TransferManager tidak mengunggah secara bersamaan.

Organisasi API Java

Paket-paket berikut dalam AWS SDK for Java menyediakan API:

  • com.amazonaws.services.s3—Menyediakan API untuk membuat klien Amazon S3 dan bekerja dengan bucket dan objek. Misalnya, ini memungkinkan Anda membuat bucket, mengunggah objek, mendapatkan objek, menghapus objek, dan kunci daftar.

  • com.amazonaws.services.s3.transfer—Menyediakan operasi data API tingkat tinggi.

    API tingkat tinggi ini dirancang untuk menyederhanakan objek transfer ke dan dari Amazon S3. API ini mencakup kelas TransferManager, yang menyediakan metode asinkron untuk bekerja dengan, melakukan kueri, dan memanipulasi transfer. API ini juga mencakup kelas TransferManagerConfiguration, yang dapat Anda gunakan untuk mengonfigurasi ukuran bagian minimum untuk mengunggah bagian dan ambang batas dalam byte tentang kapan untuk menggunakan pengunggahan multibagian.

  • com.amazonaws.services.s3.model—Menyediakan kelas API tingkat rendah untuk membuat permintaan dan respons proses. Misalnya, API ini mencakup kelas GetObjectRequest untuk menjelaskan permintaan objek Anda, kelas ListObjectsRequest untuk menjelaskan permintaan kunci daftar Anda, dan kelas InitiateMultipartUploadRequest untuk membuat unggahan multibagian.

Untuk informasi selengkapnya tentang AWS SDK for Java API, lihat Referensi AWS SDK for Java API.

Menguji Contoh Kode Java Amazon S3

Contoh Java dalam panduan ini kompatibel dengan AWS SDK for Java versi 1.11.321. Untuk petunjuk cara menyiapkan dan menjalankan contoh kode, lihat Memulai di Panduan AWS SDK for Java Pengembang.