Tablestore SDK for Java menangani kesalahan sebagai pengecualian. Topik ini menjelaskan metode penanganan kesalahan, jenis pengecualian, dan kebijakan pengulangan dalam Tablestore SDK for Java.
Metode
Tablestore SDK for Java menangani kesalahan sebagai pengecualian. Jika tidak ada pengecualian yang dikembalikan, operasi dianggap berhasil. Jika sebuah pengecualian dikembalikan, operasi dianggap gagal.
Operasi batch seperti BatchGetRow dan BatchWriteRow hanya berhasil jika sistem memverifikasi bahwa tidak ada pengecualian yang dikembalikan dan status setiap baris adalah sukses.
Pengecualian
ClientException dan TableStoreException adalah dua jenis pengecualian umum yang mungkin Anda temui saat menggunakan Tablestore SDK for Java. Kedua pengecualian tersebut merupakan turunan dari RuntimeException.
ClientException: Pengecualian internal SDK, seperti nilai parameter yang tidak valid.
TableStoreException: Kesalahan server yang diuraikan dari pesan kesalahan server. TableStoreException menyediakan informasi berikut:
getHttpStatus(): Kode status HTTP seperti 200 atau 404.
getErrorCode(): String tipe kesalahan yang dikembalikan oleh Tablestore.
getRequestId(): UID yang mengidentifikasi permintaan. Jika Anda gagal menyelesaikan masalah, catat ID permintaan dan ajukan tiket.
Kebijakan pengulangan
Tablestore SDK for Java secara otomatis mengulangi operasi ketika terjadi kesalahan. Dalam kebijakan pengulangan default, periode pengulangan maksimum adalah 10 detik. Pengulangan dilakukan untuk kesalahan pembatasan dan kesalahan server internal yang terkait dengan operasi baca.
Anda juga dapat menentukan kebijakan pengulangan kustom dengan mewarisi kelas RetryStrategy, serta mengimpor kebijakan pengulangan kustom sebagai parameter saat membuat objek OTSClient.
Tablestore SDK for Java menyediakan kebijakan pengulangan berikut:
DefaultRetryStrategy: Kebijakan pengulangan default yang hanya mengulangi operasi baca. Interval pengulangan meningkat secara eksponensial sebesar 10 ms, dengan periode pengulangan maksimum 10 detik.
AlwaysRetryStrategy: Mengulangi semua jenis permintaan. Jumlah maksimum pengulangan adalah tiga kali, dengan interval pengulangan meningkat secara eksponensial sebesar 4 ms. Interval pengulangan maksimum adalah 1 detik.