Número de expresiones
| Sigla | EXP |
| Aspecto | «Tamaño» |
| Se mide en | método |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumExpressions |
En pocas palabras
Cuenta las piezas de cálculo que hay dentro de un método: cada variable usada, cada literal, cada operación, cada
llamada. En a + b * 2 hay cinco: a, b, 2, b * 2 y la suma. Un método con pocas sentencias pero con
expresiones largas tiene un valor alto.
Qué mide
Mide cuánto cálculo concentra un método dentro de sus sentencias. Las «sentencias» dicen cuántos
pasos hay; las expresiones dicen de qué están hechos. Dos métodos con tres sentencias cada uno pueden diferir mucho:
uno con x = y; y otro con x = f(a + b, g(c) * 2);.
No tiene un sentido bueno o malo: un valor alto puede ser un método denso y difícil de leer, o simplemente un método largo. Sirve para comparar con otras medidas de tamaño y para detectar líneas muy cargadas.
Cómo se calcula
Se cuenta 1 por cada expresión del lenguaje que aparece en el método, incluidas las que están dentro de otras.
Una expresión es un literal, una referencia a una variable o a un campo, una llamada a un método, una operación
(aritmética, lógica, de comparación, de asignación, ++, --), una conversión de tipo, new, instanceof, una
lambda, una referencia a método, el operador condicional, etc.
Dos reglas evitan contar de más:
- Una expresión cuyo valor se conoce al compilar (
60 * 60, o una constantefinalinicializada con una constante) cuenta una sola vez, sin contar sus partes. - No cuentan el nombre del método que se llama (la llamada ya cuenta una vez), los calificadores que son una clase o
un paquete (
MathenMath.max(…)) ni los argumentos de las anotaciones.
Ejemplo
static int area(int w, int h) {
int limit = 60 * 60; // 60 * 60 es constante: 1
int total = w * h + 2; // +, *, w, h, 2: 5
return Math.max(total, limit); // la llamada: 1; total: 1; limit: 1; Math y max no cuentan
}
Total: 1 + 5 + 3 = 9. La constante 60 * 60 cuenta como una sola expresión aunque contenga tres (el producto y
sus dos literales). limit no está declarada final, así que no es una constante y su uso cuenta 1.
Cómo interpretarla
Es una medida informativa y Stau Metro no le da umbral de referencia. Léela junto a las sentencias: la proporción
EXP / STAT dice cuántas expresiones tiene de media cada sentencia. Un cociente alto señala sentencias densas, con llamadas
anidadas o condiciones largas, que suelen ganar legibilidad si se parten con variables intermedias de nombre claro.
Relación con otras métricas
- «Número de sentencias» (
STAT) y «sentencias ejecutables» (EXEC): la otra mitad del cuadro; las sentencias son los pasos, las expresiones su contenido. - «Longitud de Halstead» (
N): una medida cercana, que cuenta operadores y operandos en lugar de expresiones; las dos crecen juntas. - «Complejidad ciclomática» (
v(G)): cuenta las decisiones (sentencias de control y operadores&&,||,? :), no la cantidad de cálculo.
En las herramientas
Stau Metro (NumExpressions, método). Recorre el árbol sintáctico y cuenta 1 por cada expresión, incluidas
las anidadas. Cuentan los literales, las referencias a variables y campos, las llamadas, las operaciones, las
lambdas y las demás clases de expresión. Cuando una expresión es constante en tiempo de compilación se cuenta ella
sola y se omite su contenido. Un literal o una referencia a una constante final cuentan 1 como cualquier otra
expresión. Una cadena de operandos unidos por el mismo operador es una sola expresión: a + b + c vale 4 (la suma y
sus tres operandos), no 5 como si fuera (a + b) + c; a + b * c sí vale 5, porque el producto es una expresión
aparte.
No cuentan el nombre de la llamada, las referencias a una clase o a un paquete usadas como calificador de un
miembro estático, ni los argumentos de las anotaciones; todo eso lo fijan los tests del plugin (por ejemplo,
twice(a) + A.x + A.twice(a) vale 6: la suma, las dos llamadas, los dos argumentos y A.x).
Las expresiones de lambdas y de clases anónimas o locales declaradas dentro de un método se suman a ese método. No se calcula para métodos abstractos. No existe versión de clase.
No se ha comprobado que otra herramienta calcule esta misma métrica con este nombre, por lo que no se comparan aquí.