Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

throws — declarar excepciones

La palabra clave throws en la declaración de un método o constructor especifica los tipos de excepción que pueden salir de su cuerpo. Es especialmente importante para las excepciones comprobadas: el código que realiza la llamada debe gestionarlas o declarar que pueden propagarse.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

throws ExceptionType1, ExceptionType2

throws es una palabra clave reservada. La cláusula aparece después de la lista de parámetros de un método o constructor, antes del cuerpo o del punto y coma que termina la declaración. Separa los tipos con comas; cada uno debe ser un subtipo de Throwable. También se permiten variables de tipo con límites adecuados.

Si una excepción comprobada puede salir del cuerpo, la declaración debe incluir su tipo o un supertipo. El código que realiza la llamada debe capturarla mediante try/catch o declararla en su propia cláusula throws. Los subtipos de RuntimeException y Error no son comprobados: se permite incluirlos, pero no es obligatorio.

No confundas throws con throw: el primero declara una posible propagación, mientras que el segundo lanza realmente una excepción. Una cláusula throws no lanza ni gestiona nada, y tampoco garantiza que se produzca una excepción.

Al sobrescribir un método (JLS §8.4.8.3), cada tipo de excepción comprobada que se declare debe coincidir con un tipo de la cláusula throws del método sobrescrito tras el borrado de tipos, o ser un subtipo de este. De lo contrario, se produce un error de compilación. Si la condición solo se cumple tras el borrado, el compilador emite una advertencia de tipo unchecked. Por ejemplo, un método no genérico void run() throws Exception puede sobrescribir <E extends Exception> void run() throws E con esa advertencia en lugar de un error: E se convierte en Exception tras el borrado, pero antes del borrado Exception no es un subtipo de E.

En el ejemplo, check(false) lanza la excepción comprobada Exception, y main la captura e imprime su mensaje. El tipo general Exception simplifica la demostración; en una API real, es preferible usar tipos específicos que describan los posibles fallos.

Ejemplos

public class ThrowsDemo {
    static void check(boolean valid) throws Exception {
        if (!valid) {
            throw new Exception("Invalid input");
        }
    }

    public static void main(String[] args) {
        try {
            check(false);
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
    }
}

Resultado

Invalid input

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes