El SDK de Java para Tablestore genera excepciones para manejar los errores. Este tema describe los métodos de manejo de errores, los detalles de las excepciones y las políticas de reintentos.
Método
Si una llamada a la API no genera una excepción, la operación se completó correctamente. En caso contrario, la operación finalizó con errores.
Para las operaciones por lotes, como BatchGetRow y BatchWriteRow, compruebe si hay excepciones y compruebe el estado de cada fila. La llamada a la API se considera exitosa solo si todas las filas se procesan correctamente.
Excepciones
El SDK de Java para Tablestore incluye dos tipos de excepciones, ClientException y TableStoreException, las cuales heredan de RuntimeException.
ClientException: excepción interna del SDK, como la causada por una configuración incorrecta de un parámetro.
-
TableStoreException: error del lado del servidor que se genera al analizar sintácticamente un mensaje de error proveniente del servidor. Un objeto TableStoreException contiene los siguientes miembros:
getHttpStatus(): código de respuesta HTTP, como 200 o 404.
getErrorCode(): cadena del código de error devuelta por Tablestore.
getRequestId(): identificador único universal (UUID) que identifica de forma única la solicitud. Si no logra resolver un problema, registre este RequestId y envíe un ticket.
Reintentos
El SDK reintenta automáticamente una operación si ocurre un error. De manera predeterminada, solo reintenta operaciones de lectura que fallan debido a errores de limitación de tasa o errores internos del servidor. La política de reintentos predeterminada tiene una duración máxima de 10 s.
Implemente una política de reintentos personalizada mediante la herencia de la clase RetryStrategy y pase dicha política como parámetro al construir el objeto OTSClient.
A continuación se muestran las políticas de reintentos implementadas en el SDK:
DefaultRetryStrategy: política de reintentos predeterminada. Solo reintenta operaciones de lectura. El intervalo de reintento aumenta exponencialmente a partir de 10 ms, con una duración máxima de 10 s.
AlwaysRetryStrategy: reintenta todos los tipos de solicitudes hasta tres veces. El intervalo de reintento aumenta exponencialmente a partir de 4 ms, con un intervalo máximo de 1 s.