Mejores prácticas para las excepciones personalizadas de Java
Contenidos
Los tutoriales de Java han sido escritos para el JDK 8. Los ejemplos y las prácticas que se describen en esta página no aprovechan las mejoras introducidas en versiones posteriores y pueden utilizar tecnología que ya no está disponible.Consulte los cambios en el lenguaje de Java para obtener un resumen de las características actualizadas del lenguaje en Java SE 9 y las versiones posteriores.Consulte las notas de la versión del JDK para obtener información sobre las nuevas características, las mejoras y las opciones eliminadas o obsoletas de todas las versiones del JDK.
Antes de poder atrapar una excepción, algún código en algún lugar debe lanzar una. Cualquier código puede lanzar una excepción: su código, el código de un paquete escrito por alguien más, como los paquetes que vienen con la plataforma Java, o el entorno de ejecución de Java. Independientemente de lo que lance la excepción, siempre se lanza con la sentencia throw.
También puedes crear tus propias clases de excepción para representar los problemas que pueden ocurrir dentro de las clases que escribes. De hecho, si eres un desarrollador de paquetes, puede que tengas que crear tu propio conjunto de clases de excepción para permitir a los usuarios diferenciar un error que puede ocurrir en tu paquete de los errores que ocurren en la plataforma Java o en otros paquetes.
Cómo escribir una excepción personalizada en java
Así que recuerda, siempre puedes crear tus propias clases de Excepción extendiendo desde la clase Exception o una de sus subclases. Además, tenga en cuenta que la clase RuntimeException y sus subclases no son comprobadas por el compilador y no necesitan ser declaradas en la firma del método.
Por lo tanto, utilícelas con cuidado, ya que no será informado y puede no ser consciente de las excepciones que pueden ocurrir al utilizar ese método (y por lo tanto no tiene los códigos de manejo de excepciones adecuados) – una mala práctica de ingeniería de software. Una vez más, incluso Joshua Bloch ha aconsejado el uso de excepciones estándar en Java Efectivo.
Aquí hay un ejemplo completo de cómo crear una Excepción personalizada definida por el usuario en Java. Usando esto puedes manejar diferentes condiciones de error de manera diferente. Es uno de los ejemplos más sencillos para entender la necesidad de las excepciones personalizadas en Java. Aquí tenemos una clase Account, que representa una cuenta bancaria en la que se puede depositar y retirar dinero, pero ¿qué ocurrirá si se quiere retirar dinero que exceda el saldo del banco? No se le permitirá, y aquí es donde la excepción definida por el usuario entra en escena. Hemos creado una excepción personalizada llamada NotSufficientFundException para manejar este escenario. Esto le ayudará a mostrar un mensaje más significativo a los usuarios y programadores.
Cómo escribir una excepción en java
Ya hemos hablado mucho sobre el manejo de excepciones en este blog y hemos descrito las diferencias entre las excepciones comprobadas y no comprobadas, las mejores prácticas y los errores más comunes. Si has leído estos posts, probablemente hayas reconocido un patrón. Debes proporcionar información detallada sobre la situación que causó la excepción, y no debes eliminar nada que pueda ser útil para la persona que llama.
A menudo puedes lograr eso usando excepciones estándar con buenos mensajes. La clase Java Exception describe el tipo de evento, y el mensaje proporciona información detallada sobre el mismo. Puede llevar este concepto un paso más allá utilizando una excepción personalizada.
Las excepciones personalizadas le proporcionan la flexibilidad de añadir atributos y métodos que no forman parte de una excepción Java estándar. Estos pueden almacenar información adicional, como un código de error específico de la aplicación, o proporcionar métodos de utilidad que pueden ser utilizados para manejar o presentar la excepción a un usuario.
Hay 4 buenas prácticas generales que debe seguir cuando decida implementar una clase de excepción personalizada. Estas recomendaciones hacen que su código y su API sean más fáciles de entender. También reducen la cantidad de documentación necesaria. Esto vale la pena rápidamente si varios desarrolladores trabajan en la misma aplicación o biblioteca, si nuevos miembros del equipo se unen a su proyecto, o si un proveedor de software de terceros decide utilizar sus APIs.
Excepción personalizada de Java
A veces habrá situaciones en las que no quieras obligar a cada método a declarar tu implementación de la excepción en su cláusula throws. En este caso puedes crear una excepción no controlada. Una excepción no controlada es cualquier excepción que extiende java.lang.RuntimeException (que a su vez es una subclase de java.lang.Exception):
La clase java.lang.Throwable es la raíz de todos los errores y excepciones que se pueden lanzar dentro de Java. java.lang.Exception y java.lang.Error son ambas subclases de Throwable. Cualquier cosa que subclase Throwable puede ser lanzada o capturada. Sin embargo, normalmente es una mala práctica atrapar o lanzar Error, ya que se utiliza para denotar errores internos de la JVM que normalmente no pueden ser “manejados” por el programador (por ejemplo, OutOfMemoryError). De la misma manera, debes evitar atrapar Throwables, lo que podría resultar en la captura de Errores además de Excepciones.
Técnicamente, cualquier cosa que extienda a Throwable puede ser un throwable, pero las excepciones son generalmente extensiones de la clase Exception, por lo que son excepciones verificadas (excepto RuntimeException o las clases basadas en ella, que no son verificadas), en contraposición al otro tipo común de throwable, los Errores, que generalmente no son algo diseñado para ser manejado con gracia más allá de los internos de la JVM.
