El SDK de Kotlin utiliza una jerarquía de excepciones para ayudar a los desarrolladores a gestionar los fallos en las llamadas a la API. Existen dos categorías principales de excepciones que su aplicación debe gestionar al usar el SDK de Kotlin:
Loserrores de dominio ocurren cuando falla una lectura o escritura en el dominio. Estos errores generan un Excepción de reino.
Los errores de aplicación ocurren cuando falla la comunicación de red con Atlas App Services. Estos errores generan una AppException. Para obtener más información sobre errores de aplicación, consulte "Gestionar errores de aplicación". Para obtener más información sobre errores de sincronización específicos de la aplicación,consulte "Gestionar errores de sincronización".
Realm Errors
Los errores de dominio ocurren cuando falla la lectura o escritura de una base de datos por cualquier motivo. Siempre que es posible, el SDK utiliza excepciones de plataforma existentes, como IllegalArgumentException.o IllegalStateException.
Normalmente, estos errores son resultado de una lógica de base de datos incorrecta, como una consulta a la que le falta un argumento, un intento de escribir fuera de una transacción de escritura o la eliminación de un objeto que no existe.
Sin embargo, algunos errores son efímeros: ocurren debido a fallos ajenos al control del cliente o del SDK. Cuando se produce un error efímero, debe reintentar la operación que lo causó. Si la operación sigue fallando al reintentarla, investigue soluciones lógicas.
Puedes gestionar errores en el SDK con la API runCatching integrada de Kotlin. Usa el onSuccess y onFailure devoluciones de llamadas del resultado devuelto para manejar llamadas exitosas a la API del SDK y casos de error.