Número de excepciones capturadas
| Sigla | CAUGHT |
| 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 | NumExceptionsCaught |
En pocas palabras
Cuenta cuántos tipos distintos de excepción atrapa un método con catch. Si captura el mismo tipo en tres sitios,
cuenta una vez. Dice cuánta variedad de fallos prevé el método y resuelve por sí mismo.
Qué mide
La parte del tratamiento de errores que se queda dentro del método, en variedad y no en cantidad de bloques. Un
método que captura cinco tipos distintos tiene más caminos de error que entender que uno que captura uno solo, aunque
tenga el mismo número de catch.
Es una puntuación y no un recuento corriente: sumarla entre métodos no tiene sentido (dos métodos que capturan
IOException no suman dos tipos), y por eso Stau Metro no muestra su total en los resultados, solo la media, el
mínimo y el máximo.
Cómo se calcula
Se recogen los tipos de todas las cláusulas catch del método, cada uno por su nombre completo, y se cuentan los
distintos. Un catch con varias alternativas (catch (A | B e)) aporta cada una de sus alternativas.
Ejemplo
void load(Path path) {
try {
read(path);
} catch (FileNotFoundException e) { // FileNotFoundException
log(e);
} catch (IOException | UncheckedIOException e) { // IOException, UncheckedIOException
log(e);
}
try {
close();
} catch (IOException e) { // ya contado
log(e);
}
}
Total: 3 tipos distintos (FileNotFoundException, IOException, UncheckedIOException), aunque hay tres
cláusulas catch y cuatro tipos escritos.
Cómo interpretarla
No tiene umbrales. Un valor alto puede indicar un método que mezcla demasiadas responsabilidades (lee, convierte y escribe, y se ocupa de los fallos de cada paso), o capturas muy finas que podrían agruparse en una excepción propia. Un valor 0 es normal: lo habitual es que un método deje subir las excepciones a quien sabe qué hacer con ellas. Léela junto a «las excepciones lanzadas» para ver el equilibrio entre lo que el método declara y lo que resuelve.
Relación con otras métricas
- «Número de excepciones lanzadas» (
THROWS): la otra mitad, lo que el método deja pasar a quien lo llama. - «Complejidad ciclomática» (
v(G)): cadacatchsuma 1 env(G)de Stau Metro, de modo que los métodos con muchoscatchsuelen tener un valor alto en ambas. - «Número de sentencias de control» (
CONTROL): cuenta eltry, no elcatch.
En las herramientas
Stau Metro (NumExceptionsCaught, a nivel de método). Cuenta los tipos distintos, identificados por su nombre
completo, de los parámetros de todos los catch del método, cada alternativa de un catch múltiple por separado:
catch (A | B e) aporta 2 si ninguno de los dos tipos se había contado ya. Los catch de lambdas y de clases
anónimas o locales declaradas dentro del método se suman a él. No se calcula para los métodos abstractos. Es una
puntuación: no se muestra su total en los resultados.
CK (herramienta de Aniche). Su tryCatchQty se describe como «el número de try/catches»; no distingue, según esa
descripción, tipos distintos.
Referencias
- Aniche, M., herramienta CK, descripción de métricas: https://github.com/mauricioaniche/ck