Número de expresiones

Actualizado el 15 de noviembre de 2026

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 constante final inicializada 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 (Math en Math.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

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í.