Tamaño máximo de las operaciones
| Sigla | OSmax |
| Aspecto | «Tamaño» |
| Se mide en | clase |
| Tipo de valor | valor numérico: el máximo de un recuento (entero, mínimo 0) |
| Dirección | más alto es peor |
| Stau Metro | MaximumOperationSize |
En pocas palabras
Es el número de sentencias del método más largo de la clase. Sirve para encontrar el método que más conviene dividir, aunque el resto de la clase esté bien.
Qué mide
Lo que no ve una media: la concentración. Una clase puede tener métodos cortos en casi todos los casos y uno enorme que lo hace todo. El «tamaño promedio» apenas lo notaría; el máximo lo señala directamente.
Ojo. Pese al nombre, cuenta sentencias, no líneas de código.
Cómo se calcula
Las reglas de qué es una sentencia y qué método cuenta son las mismas que en el «tamaño promedio»: no cuentan las llaves de bloque ni la sentencia vacía; las sentencias de lambdas y de clases anónimas o locales de un método se suman a ese método; los bloques de inicialización quedan fuera; los constructores cuentan como métodos; y una clase sin métodos con cuerpo no tiene valor.
Ejemplo
class Outer {
void big() { a(); a(); a(); } // 3 sentencias
void small() { } // 0
void a() { } // 0
static class Inner { // clase aparte: valor propio
void m() { }
}
}
Outer vale 3, el máximo entre 3, 0 y 0; Inner vale 0. La clase anidada no cambia el máximo de la que la contiene.
Este fragmento es, en esencia, el de un test del proyecto.
Si en un método se declara una clase anónima, sus sentencias se suman a las del método:
void m() {
a(); // 1
Runnable r = new Runnable() { // 1 (la declaración)
public void run() { a(); } // 1 (se suma a m)
};
a(); // 1
} // total 4
Cómo interpretarla
Sin umbral de referencia en Stau Metro. Un valor alto marca un método candidato a dividirse aunque los demás sean cortos; un valor bajo, que todos lo son. Compáralo con el promedio: si el máximo es varias veces la media, el método largo es una excepción dentro de la clase; si ambos son altos, el problema es general.
Un método largo no es siempre un defecto: una tabla de datos o un método que construye un objeto con muchos pasos iguales puede ser largo y trivial. Para saber si es difícil de seguir, mira también su «complejidad ciclomática».
Relación con otras métricas
- «Tamaño promedio de las operaciones» (
OSavg): la media del mismo recuento. - «Complejidad máxima de las operaciones» (
OCmax): el máximo de la complejidad en lugar del tamaño. - «Número de sentencias» (
STAT):OSmaxes el mayor valor deSTATentre los métodos y constructores de la clase. - «Líneas de código» (
LOC): el tamaño de un método en líneas.
En las herramientas
Stau Metro (MaximumOperationSize, a nivel de clase). Se calcula para clases con nombre, incluidas las
abstractas, los enumerados y los records; no para interfaces. Los métodos de una clase anónima de un inicializador
de campo, o del cuerpo de una constante de enumerado, no cuentan como operaciones de la clase ni aportan sentencias.
Un for clásico suma hasta tres sentencias propias más las de su cuerpo (ver el tamaño promedio).
MetricsReloaded (OSmax). Su descripción la define como el tamaño máximo, en sentencias, de los métodos no
abstractos de la clase, sin contar los heredados, y cuenta las sentencias igual. En su código, un método de una
clase anónima reinicia el recuento, de modo que sus sentencias no se suman enteras al método que la contiene.
Referencias
- MetricsReloaded, descripción de Maximum operation size: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/metricsDescriptions/metricsDescriptions/MaximumOperationSize.html
- MetricsReloaded, código del cálculo: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/src/com/sixrr/stockmetrics/classCalculators/MaximumOperationSizeCalculator.java