Complejidad promedio de las operaciones
| Sigla | OCavg |
| Aspecto | «Complejidad» |
| Se mide en | clase |
| Tipo de valor | media (decimal, mínimo 1) |
| Dirección | más alto es peor |
| Umbrales de referencia | aviso por encima de 3,1, error por encima de 4,7 (Stau Metro) |
| Stau Metro | AverageOperationComplexity |
En pocas palabras
Dice cuántas decisiones tiene, de media, cada método de una clase. Una clase con métodos cortos y directos da un
valor cercano a 1; una en la que casi todos los métodos tienen varios if y bucles da un valor alto. Es un resumen
del estilo de la clase, no de su tamaño.
Qué mide
La complejidad típica de los métodos de una clase. Separa dos cosas que la
«complejidad ponderada de los métodos» (WMC) mezcla: una clase puede tener un
WMC alto porque tiene muchos métodos o porque sus métodos son complicados. La media responde a la segunda
pregunta. Una «operación», en la terminología de las métricas orientadas a objetos, es un método.
Cómo se calcula
Con la complejidad de cada uno de los métodos con cuerpo de la clase:
Es decir, la suma de las complejidades dividida entre el número de métodos. Como medida de cada método se usa la
«complejidad ciclomática» o una variante; en Stau Metro, el mismo recuento que su WMC.
Una clase sin métodos con cuerpo no tiene valor.
Ejemplo
Con las reglas de Stau Metro (cuentan if, bucles, ? : y grupos de case, pero no &&, || ni catch):
abstract class Shape {
abstract double area(); // sin cuerpo: no entra
String size() { // 1
double a = area();
if (a < 1) { // +1
return "small";
}
return a < 100 ? "medium" : "large"; // +1
}
boolean isEmpty() { // 1
return area() == 0;
}
}
Hay dos métodos con cuerpo: size vale 3 e isEmpty vale 1. OCavg = (3 + 1) / 2 = 2,0. El WMC de la clase
es 4 y su OCmax, 3.
Cómo interpretarla
Stau Metro usa como referencia aviso por encima de 3,1 y error por encima de 4,7, y los presenta como los
valores «alto» y «muy alto» que dan Lanza y Marinescu (2006) para Java. Una media de 3,1 significa que el método
típico tiene unas dos decisiones: no es mucho por método, pero sí como costumbre de toda una clase. Como en
«WMC», el recuento de Stau Metro no incluye &&, || ni catch, y da medias
iguales o más bajas que una media de la complejidad ciclomática completa.
- Media alta: la complejidad está repartida. Simplificar un método no basta; hay que revisar cómo se ha diseñado la clase (condicionales repetidos que piden polimorfismo, validaciones copiadas en cada método).
- Media baja con
WMCalto: muchos métodos sencillos. El problema, si lo hay, es de tamaño o de responsabilidades, no de complejidad.
Ojo. Una media esconde los extremos. Una clase con diez métodos triviales y uno de complejidad 25 tiene una media por debajo de 4. Léela siempre con la «complejidad máxima de las operaciones» (
OCmax).
Los getters, setters y constructores triviales valen 1 y bajan la media. Dos clases con la misma lógica dan medias distintas si una tiene más accesores que la otra.
Relación con otras métricas
- «Complejidad ponderada de los métodos» (
WMC): el numerador de esta media, salvo por los métodosnative, queWMCcuenta con 1 y esta media deja fuera. - «Complejidad máxima de las operaciones» (
OCmax): el extremo que la media puede ocultar; se leen juntas. - «Complejidad ciclomática» (
v(G)): la medida por método de la que esta es la media, con otro recuento en Stau Metro. - «Complejidad ciclomática promedio» (
v(G)avg): la misma idea por paquete, módulo o proyecto. - «Tamaño promedio de las operaciones» (
OSavg): la media del tamaño de los mismos métodos; si las dos son altas, los métodos son largos y con muchas decisiones. - «Número promedio de parámetros» (
OPavg): otra media por método de la clase.
En las herramientas
Stau Metro (AverageOperationComplexity, a nivel de clase). Suma, para cada método escrito en la clase que
tenga cuerpo, 1 más 1 por cada if, for, for mejorado, while, do … while, operador ? :, grupo de case de
un switch con dos puntos o regla de uno con flechas (sin contar default) y guarda when, y divide entre el
número de esos métodos. No cuenta &&, || ni catch. Además:
- entran los constructores; los métodos abstractos y los
native, que no tienen cuerpo, no entran ni en la suma ni en el número de métodos (enWMC, unnativesí suma 1, así que con métodosnativeOCavgno es exactamenteWMCentre el número de métodos); - solo entran los métodos de la propia clase; cada clase anidada con nombre tiene su propio valor;
- las decisiones de las lambdas y de las clases anónimas o locales declaradas dentro de un método cuentan para ese método; las clases anónimas y locales no tienen valor propio;
- no cuentan los inicializadores de campos (ni los métodos de una clase anónima creada en uno), los bloques de inicialización ni los cuerpos de las constantes de un enumerado;
- se calcula para clases, también abstractas, enumerados y registros, pero no para interfaces; los métodos generados por el compilador en enumerados y registros no cuentan;
- una clase sin métodos con cuerpo no tiene valor.
MetricsReloaded (complemento para IntelliJ IDEA). Su código fuente calcula OCavg como la suma de 1 por método
con cuerpo más 1 por cada if, bucle, ? : y grupo de etiquetas de un switch con dos puntos (también el de
default; las reglas con flecha no cuentan), dividida entre el número de esos métodos.
Referencias
- Lanza, M. y Marinescu, R. (2006). Object-Oriented Metrics in Practice. Springer. https://doi.org/10.1007/3-540-39538-5
- MetricsReloaded, código fuente: https://github.com/BasLeijdekkers/MetricsReloaded