Número de excepciones lanzadas

Actualizado el 15 de noviembre de 2026

Sigla THROWS
Aspecto «Complejidad»
Se mide en método
Tipo de valor puntuación (entero, mínimo 0): un número que sirve para comparar métodos, no para sumar
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumExceptionsThrown

En pocas palabras

Cuenta los tipos de excepción que aparecen en la cláusula throws de un método, es decir, los fallos que el método anuncia a quien lo llama. No cuenta las sentencias throw del cuerpo.

Qué mide

Cuántos tipos de fallo expone el método en su firma. Cada uno obliga, si es una excepción comprobada, a quien llama a capturarla o a volver a declararla; cuantos más tipos, más carga para los llamadores y más acoplada queda la firma a los detalles de lo que hay debajo.

Ojo. Pese al nombre, no mide cuántas excepciones lanza el método con throw. Un método que lanza cinco excepciones sin declararlas vale 0, y uno que declara throws IOException sin lanzar nada vale 1.

Cómo se calcula

Número de tipos escritos en la cláusula throws del método. Si el método no la tiene, 0.

Ejemplo

void copy(Path from, Path to) throws IOException, InterruptedException {  // 2
    Files.copy(from, to);
    Thread.sleep(1);
}

void parse(String s) throws IllegalArgumentException {                    // 1: aunque no sea comprobada
    Integer.parseInt(s);
}

void check(int x) {                                                        // 0: el throw no cuenta
    if (x < 0) throw new IllegalStateException();
}

Cómo interpretarla

No tiene umbrales de Stau Metro. Como orientación externa, el valor por defecto de Checkstyle para su comprobación ThrowsCount es 4 tipos como máximo; esa comprobación ignora siempre los métodos anotados con @Override, porque la clase no puede cambiar su firma, y por defecto también los privados, que no afectan a otras clases. Una lista larga de throws suele indicar que el método hace demasiado o que expone excepciones de bajo nivel; la salida habitual es capturarlas y lanzar una excepción propia del nivel de abstracción del método.

Relación con otras métricas

En las herramientas

Stau Metro (NumExceptionsThrown, a nivel de método). Cuenta los tipos de la cláusula throws, comprobados o no. Solo mira la firma del método medido: no cuenta las sentencias throw ni las cláusulas throws de métodos de clases anónimas o locales declaradas dentro de él. A diferencia de casi todas las métricas de método, también se calcula para los métodos abstractos y los de interfaz (incluidos los elementos de una anotación, que valen 0), porque su firma puede declarar throws igual que la de los demás. Por eso tiene más filas que las otras métricas de método. Es una puntuación: Stau Metro no muestra su total en los resultados, solo la media, el mínimo y el máximo.

Checkstyle (ThrowsCount). Limita el número de tipos en throws; máximo por defecto 4, un valor que su documentación presenta como empírico, sacado de proyectos grandes como OpenJDK. Omite siempre los métodos con @Override y, con ignorePrivateMethods (activado por defecto), los privados.

Referencias