Tratamiento de excepciones - AWS SDK for Java 1.x

La AWS SDK for Java versión 1.x entró en modo de mantenimiento el 31 de julio de 2024 y estará disponible el 31 de end-of-supportdiciembre de 2025. Le recomendamos que migre al para AWS SDK for Java 2.xseguir recibiendo nuevas funciones, mejoras de disponibilidad y actualizaciones de seguridad.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Tratamiento de excepciones

Comprender cómo y cuándo se producen AWS SDK for Java excepciones es importante para crear aplicaciones de alta calidad utilizando. SDK En las siguientes secciones se describen los diferentes casos de excepciones que genera SDK y cómo gestionarlos adecuadamente.

¿Por qué usar excepciones no controladas?

AWS SDK for Java Utiliza excepciones en tiempo de ejecución (o no comprobadas) en lugar de excepciones marcadas por los siguientes motivos:

  • Para permitir a los desarrolladores un control minucioso de los errores que desean administrar sin obligarles a abordar casos excepcionales que no les preocupan (o que les obligan a detallar su código en exceso)

  • Para evitar problemas de escalabilidad inherentes a las excepciones controladas en aplicaciones grandes

En general, las excepciones controladas funcionan bien a pequeña escala, pero pueden ser problemáticas cuando las aplicaciones crecen y se vuelven más complejas.

Para obtener más información sobre el uso de excepciones controladas y no controladas, consulte:

AmazonServiceException (y subclases)

AmazonServiceExceptiones la excepción más común que experimentará al AWS SDK for Java usar. Esta excepción representa una respuesta de error de un servicio de Servicio de AWS. Por ejemplo, si intentas terminar una Amazon EC2 instancia que no existe, EC2 devolverá una respuesta de error y todos los detalles de esa respuesta de error se incluirán en la AmazonServiceException que se arroje. En algunos casos, se produce una subclase de AmazonServiceException para permitir a los desarrolladores un control minucioso del tratamiento de casos de error a través de bloques de captura.

Cuando encuentres unaAmazonServiceException, sabrás que tu solicitud se envió correctamente, Servicio de AWS pero que no se pudo procesar correctamente. Esto puede ser debido a errores en los parámetros de la solicitud o a problemas en el servicio.

AmazonServiceException proporciona información como:

  • Código HTTP de estado devuelto

  • Código AWS de error devuelto

  • Mensaje de error detallado del servicio

  • AWS ID de solicitud de la solicitud fallida

AmazonServiceExceptiontambién incluye información sobre si la solicitud fallida fue culpa de la persona que llamó (una solicitud con valores no válidos) o fue culpa Servicio de AWS de la persona que llamó (un error de servicio interno).

AmazonClientException

AmazonClientExceptionindica que se ha producido un problema en el código del cliente de Java, ya sea al intentar enviar una solicitud AWS o al analizar una respuesta. AWS Un AmazonClientException es generalmente más grave que uno e indica un problema importante que impide al cliente realizar llamadas de servicio a AWS los servicios. AmazonServiceException Por ejemplo, AmazonClientException si no hay ninguna conexión de red disponible cuando se intenta llamar a una operación en uno de los clientes. AWS SDK for Java