Número de sentencias de bucle
| Sigla | LOOP |
| Aspecto | «Complejidad» |
| Se mide en | método |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumLoops |
En pocas palabras
Cuenta los bucles de un método, estén uno dentro de otro o uno detrás de otro. Un método con varios bucles recorre datos varias veces, y cada recorrido es un sitio donde entender el flujo y probar los casos límite (vacío, uno, muchos).
Qué mide
Cuánta iteración explícita hay en el método. No dice cuánto cuesta ejecutarlo: un bucle puede recorrer tres elementos o tres millones, y dos bucles uno dentro de otro multiplican el trabajo, pero para esa diferencia está la «profundidad de anidamiento de bucles».
Cómo se calcula
Se suma 1 por cada for, for mejorado, while y do … while.
Ejemplo
void process(List<List<String>> table, List<String> extra) {
for (List<String> row : table) { // +1
for (String cell : row) { // +1
use(cell);
}
}
int i = 0;
while (i < 3) { i++; } // +1
do { i--; } while (i > 0); // +1
extra.forEach(s -> { for (char c : s.toCharArray()) { use(c); } }); // +1: el bucle de la lambda
}
Total: 5. La llamada forEach no es un bucle del lenguaje y no suma; el bucle de dentro de la lambda, sí.
Cómo interpretarla
No tiene umbrales. Un valor alto indica un método que recorre varias colecciones o que mezcla pasos de
procesamiento; suele ser candidato a dividirse en métodos pequeños, uno por recorrido. Un valor 0 es normal en
métodos de acceso o de coordinación. Compáralo con la profundidad de anidamiento de bucles: dos bucles seguidos
(LOOP 2, profundidad 1) se leen con mucha más facilidad que dos anidados (LOOP 2, profundidad 2).
Relación con otras métricas
- «Profundidad de anidamiento de bucles» (
LOOP_NEST): si los bucles están anidados o en secuencia. - «Número de sentencias de ramificación» (
BRANCH): losbreakycontinueque alteran el curso de estos bucles. - «Número de sentencias de control» (
CONTROL): los bucles son parte de este total. - «Complejidad ciclomática» (
v(G)): cada bucle suma 1.
En las herramientas
Stau Metro (NumLoops, a nivel de método). Cuenta for, for mejorado, while y do … while, a cualquier
nivel de anidamiento. Los bucles dentro de lambdas y de clases anónimas o locales declaradas en el método se suman
a él. Las llamadas que iteran por dentro (forEach, streams) no cuentan. No se calcula para los métodos
abstractos.
CK (herramienta de Aniche). Su loopQty cuenta «el número de bucles (es decir, for, while, do while, for
mejorado)», las mismas cuatro construcciones.
Referencias
- Aniche, M., herramienta CK, descripción de métricas: https://github.com/mauricioaniche/ck