Número de métodos
| Sigla | METH (METH(rec) en la variante recursiva del paquete) |
| Aspecto | «Tamaño» |
| Se mide en | paquete, módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Origen | recuento de uso general; como NOM, Lanza y Marinescu (2006) |
| Familia | «Lanza y Marinescu» |
| Stau Metro | NumMethodsPackage, NumMethodsRecursivePackage, NumMethodsModule, NumMethodsProject |
En pocas palabras
Cuenta los métodos que se han escrito en un paquete, un módulo o un proyecto. Es el indicador de tamaño más amplio de cuánto comportamiento define el código: más métodos, más cosas que sabe hacer el programa.
Qué mide
La cantidad de operaciones declaradas. Es una medida de tamaño más cercana al diseño que las líneas de código: un método largo y diez cortos pueden tener las mismas líneas y no el mismo número de métodos. Las líneas dicen cuánto código hay; los métodos, entre cuántas piezas con nombre se reparte.
A nivel de clase la misma idea se llama número de métodos (NOM) y es una de las medidas clásicas de tamaño de
clase. Aquí se agrega por paquete, módulo y proyecto.
Cómo se calcula
Se cuenta 1 por cada método declarado en el código fuente. La definición habitual (por ejemplo, la de PHP_Depend
para el NOM de Lanza y Marinescu) habla de «métodos declarados» sin más; si entran los constructores o los
métodos de las clases anónimas depende de la herramienta. Stau Metro cuenta ambos.
Ejemplo
package demo;
public class Counter {
private int n;
Counter() { } // 1 constructor explícito
void inc() { n++; } // 2
int get() { return n; } // 3
Runnable reset() { // 4
return new Runnable() {
public void run() { n = 0; } // 5 método de una clase anónima
};
}
Runnable log() { return () -> {}; } // 6 el método log; la lambda no es un método
}
METH del paquete demo = 6: el constructor, inc, get, reset, run y log. La lambda de log no suma. Si
se quitara el constructor escrito, el valor bajaría a 5: un constructor por defecto que el compilador añade no figura
en el código y no se cuenta.
Cómo interpretarla
No tiene valor bueno ni malo y no tiene umbrales. Se usa para comparar y para normalizar:
- entre paquetes y módulos, señala los que concentran más comportamiento;
- dividido por el número de «clases», da los métodos por clase (
NOM/NOC, uno de los cocientes de la pirámide de Lanza y Marinescu); las «líneas de código» divididas porMETHdan el tamaño medio de un método (LOC/NOMen la pirámide); - en el tiempo, un crecimiento más rápido que el de las clases suele indicar clases que engordan.
Ojo. El recuento mezcla métodos de naturaleza muy distinta: los accesores de una línea cuentan igual que un método con lógica. Dos proyectos con el mismo
METHpueden tener una complejidad muy diferente; para eso están la «complejidad ponderada» y las demás métricas de complejidad.
Relación con otras métricas
- «Número de clases» (
C) y «número de paquetes» (P): los otros recuentos de estructura; juntos dan los cocientes de la pirámide de visión general. - «Complejidad ponderada de los métodos» (
WMC): suma la complejidad en lugar de contar uno por método. - «Tamaño de la clase (operaciones)» (
CSO): el recuento de operaciones a nivel de clase. - «Número de lambdas» (
LAMBDA): el otro tipo de pieza de comportamiento, que no se cuenta aquí.
En las herramientas
Stau Metro (NumMethodsPackage, NumMethodsRecursivePackage, NumMethodsModule, NumMethodsProject). Cuenta
cada método de los ficheros Java del análisis. Entran:
- los métodos abstractos y los de interfaz, los constructores escritos y los métodos de anotación;
- los métodos de clases anidadas, locales y anónimas, y los de los cuerpos de constantes de un enumerado;
- los métodos de código de test.
No entran las lambdas ni las referencias a método, los constructores por defecto, ni los métodos que el compilador
genera (accesores de un record, values() y valueOf de un enumerado), porque no figuran en el fuente; sí cuenta
un accesor o un constructor de record escrito a mano. Los ficheros Kotlin no se miran. Un módulo o un paquete sin
ficheros Java no tiene valor de METH, a diferencia de «J», que en un módulo así da 0.
Una clase con un método y, dentro de él, una clase anónima con otro método da 2, tanto en el módulo como en el
proyecto. El método se asigna al paquete del directorio de su fichero (no al de la sentencia package) y al módulo
al que pertenece; el valor del proyecto es la suma de los módulos. Los métodos de código de test entran si el ámbito
lo incluye.
La variante recursiva del paquete (METH(rec)) suma los métodos del paquete y los de todos sus subpaquetes: el valor
de com.acme incluye los de com.acme.core, com.acme.lib… Un paquete sin ficheros propios, como com cuando
todo el código está en com.acme, tiene fila con el total de sus subpaquetes. El paquete por defecto, en cambio,
recibe solo los suyos, no los de todo el proyecto.
SonarQube define functions como el número de funciones y precisa, para Java, que «los métodos en clases
anónimas se ignoran». Stau Metro los cuenta, de modo que para el mismo código los valores pueden diferir.
CK (Aniche) cuenta los métodos de cada clase, constructores incluidos, y trata una clase anónima o interna como una clase nueva; sus métodos se atribuyen a ella y no a la clase que la contiene.
Referencias
- Lanza, M. y Marinescu, R. (2006). Object-Oriented Metrics in Practice. Springer. ISBN 978-3-540-24429-5.
- PHP_Depend, informe de la pirámide de visión general (define NOM como el número de métodos declarados): https://pdepend.org/documentation/handbook/reports/overview-pyramid.html
- SonarQube, definición de métricas: https://docs.sonarsource.com/sonarqube-server/latest/user-guide/code-metrics/metrics-definition/
- CK, README: https://github.com/mauricioaniche/ck