Gestión de excepciones en el SDK de Rapid para Java

El SDK de Rapid para Java utiliza excepciones de tiempo de ejecución (no controladas) para transmitir errores. En la raíz de la jerarquía de excepciones está OpenWorldException, desde donde se despliegan el resto de excepciones. OpenWorldException nunca se lanza directamente.

Hay dos categorías de OpenWorldException:

1. OpenWorldServiceException: se lanza cuando el servicio descendente devuelve una respuesta de error, es decir, que el servicio recibió la solicitud pero no pudo procesarla. El objeto de la excepción proporciona información sobre el error al cliente, incluido un código de estado HTTP y un mensaje detallado. OpenWorldAuthException es un subtipo de esta excepción, y se lanza cuando se produce un error de verificación.

2. OpenWorldClientException: se lanza cuando se producen errores del cliente, ya sea al intentar enviar la solicitud o al analizar la respuesta. Por ejemplo, OpenWorldConfigurationException se lanza si no se han configurado las credenciales.

Dado que las excepciones son no controladas, el cliente decidió cuáles gestionar. En principio, se supone que OpenWorldClientException no puede volver a intentarse y debe corregirse durante el desarrollo. OpenWorldServiceException, por otro lado, podría ser recuperable, así como los errores resultantes de un servicio que no está disponible temporalmente. Por lo tanto, la gestión de errores debe centrarse en el último.