Número de excepciones lanzadas
| 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 declarathrows IOExceptionsin 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
- «Número de excepciones capturadas» (
CAUGHT): lo que el método resuelve por sí mismo, frente a lo que declara. - «Número de parámetros» (
NP): la otra mitad de lo que ve quien llama a un método en su firma.
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
- Checkstyle, comprobación
ThrowsCount: https://checkstyle.sourceforge.io/checks/design/throwscount.html