AWS SDK untuk Java 1.x mencapai akhir dukungan pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke AWS SDK for Java 2.x untuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Penanganan Pengecualian
Memahami bagaimana dan kapan peng AWS SDK untuk Java ecualian melempar penting untuk membangun aplikasi berkualitas tinggi menggunakan SDK. Bagian berikut menjelaskan berbagai kasus pengecualian yang dilemparkan oleh SDK dan cara menanganinya dengan tepat.
Mengapa Pengecualian Tidak Dicentang?
Menggunakan AWS SDK untuk Java pengecualian runtime (atau tidak dicentang) alih-alih pengecualian yang dicentang karena alasan ini:
-
Untuk memungkinkan pengembang kontrol halus atas kesalahan yang ingin mereka tangani tanpa memaksa mereka untuk menangani kasus luar biasa yang tidak mereka khawatirkan (dan membuat kode mereka terlalu bertele-tele)
-
Untuk mencegah masalah skalabilitas yang melekat pada pengecualian yang diperiksa dalam aplikasi besar
Secara umum, pengecualian yang diperiksa bekerja dengan baik pada skala kecil, tetapi dapat menjadi merepotkan saat aplikasi tumbuh dan menjadi lebih kompleks.
Untuk informasi selengkapnya tentang penggunaan pengecualian yang dicentang dan tidak dicentang, lihat:
AmazonServiceException (dan Subclass)
AmazonServiceExceptionadalah pengecualian paling umum yang akan Anda alami saat menggunakan AWS SDK untuk Java. Pengecualian ini mewakili respons kesalahan dari Layanan AWS. Misalnya, jika Anda mencoba menghentikan Amazon EC2 instans yang tidak ada, EC2 akan mengembalikan respons kesalahan dan semua detail respons kesalahan tersebut akan disertakan dalam AmazonServiceException yang dilemparkan. Untuk beberapa kasus, subkelas dilemparkan AmazonServiceException untuk memungkinkan pengembang memiliki kontrol halus atas penanganan kasus kesalahan melalui blok tangkapan.
Ketika Anda menemukanAmazonServiceException, Anda tahu bahwa permintaan Anda berhasil dikirim ke Layanan AWS tetapi tidak dapat berhasil diproses. Ini bisa karena kesalahan dalam parameter permintaan atau karena masalah di sisi layanan.
AmazonServiceExceptionmemberi Anda informasi seperti:
-
Mengembalikan kode status HTTP
-
Kode AWS kesalahan yang dikembalikan
-
Pesan kesalahan terperinci dari layanan
-
AWS ID permintaan untuk permintaan yang gagal
AmazonServiceExceptionjuga mencakup informasi tentang apakah permintaan yang gagal adalah kesalahan penelepon (permintaan dengan nilai ilegal) atau kesalahan (kesalahan layanan internal). Layanan AWS
AmazonClientException
AmazonClientExceptionmenunjukkan bahwa masalah terjadi di dalam kode klien Java, baik saat mencoba mengirim permintaan ke AWS atau saat mencoba mengurai respons dari AWS. An AmazonClientException umumnya lebih parah daripadaAmazonServiceException, dan menunjukkan masalah utama yang mencegah klien melakukan panggilan layanan ke AWS layanan. Misalnya, mel AWS SDK untuk Java empar AmazonClientException jika tidak ada koneksi jaringan yang tersedia saat Anda mencoba memanggil operasi pada salah satu klien.
