Le SDK Java Tablestore lève des exceptions pour gérer les erreurs. Cette rubrique décrit les méthodes de gestion des erreurs, le détail des exceptions et les politiques de nouvelle tentative.
Méthode
Si un appel d'API ne lève aucune exception, l'opération a réussi. Sinon, elle a échoué.
Pour les opérations par lot, telles que BatchGetRow et BatchWriteRow, vous devez vérifier la présence d'exceptions et contrôler l'état de chaque ligne. L'appel d'API est considéré comme réussi uniquement si toutes les lignes ont été traitées avec succès.
Exceptions
Le SDK Java Tablestore comprend deux types d'exceptions, ClientException et TableStoreException, qui héritent toutes deux de RuntimeException.
ClientException : exception interne au SDK, provoquée par exemple par un paramétrage incorrect.
-
TableStoreException : erreur côté serveur générée lors de l'analyse d'un message d'erreur renvoyé par le serveur. Un objet TableStoreException contient les membres suivants :
getHttpStatus() : code de retour HTTP, tel que 200 ou 404.
getErrorCode() : chaîne du code d'erreur renvoyée par Tablestore.
getRequestId() : identifiant universel unique (UUID) de la requête. Si vous ne parvenez pas à résoudre un problème, notez cet ID de requête et soumettez un ticket.
Nouvelle tentative
Le SDK relance automatiquement une opération en cas d'erreur. Par défaut, il effectue de nouvelles tentatives uniquement pour les opérations de lecture qui échouent en raison d'erreurs de limitation ou d'erreurs internes du serveur. La politique de nouvelle tentative par défaut prévoit une durée maximale de 10 s.
Implémentez une politique de nouvelle tentative personnalisée en héritant de la classe RetryStrategy, puis transmettez cette politique en tant que paramètre lors de la construction de l'objet OTSClient.
Les politiques de nouvelle tentative suivantes sont implémentées dans le SDK :
DefaultRetryStrategy : politique de nouvelle tentative par défaut. Elle concerne uniquement les opérations de lecture. L'intervalle entre les tentatives augmente de manière exponentielle à partir de 10 ms, avec une durée maximale de 10 s.
AlwaysRetryStrategy : relance tous les types de requêtes jusqu'à trois fois. L'intervalle entre les tentatives augmente de manière exponentielle à partir de 4 ms, avec un intervalle maximal de 1 s.