Número de comandos
| Sigla | Command |
| Aspecto | «Tamaño» |
| Se mide en | clase, interfaz |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Origen | la idea de separar comandos y consultas, de Bertrand Meyer (Object-Oriented Software Construction, 1988) |
| Stau Metro | NumCommandsClass, NumCommandsInterface |
En pocas palabras
Cuenta los métodos que no devuelven nada (void). Esos métodos existen para hacer algo: cambian el estado del objeto
o producen un efecto fuera de él. Su contrapartida son las «consultas», que devuelven un dato.
Qué mide
Cuánto de la interfaz de una clase son acciones. Procede de la idea de separar los métodos en dos clases: las consultas, que devuelven un resultado sin cambiar el estado observable, y los comandos, que cambian el estado y no devuelven valor. Meyer acuñó el principio en Object-Oriented Software Construction; Martin Fowler lo resume en esos términos.
Ojo. La métrica no comprueba el principio. Solo mira el tipo de retorno: un método
voides un comando aunque no cambie nada, y uno que devuelve un valor es una consulta aunque cambie estado (comopopen una pila).
Cómo se calcula
Se cuenta 1 por cada método declarado directamente en la clase o interfaz cuyo tipo de retorno es void.
- Los constructores no cuentan.
- Los métodos heredados no cuentan.
- Cuentan los métodos abstractos, estáticos, privados y, en interfaces, los
default. Los métodos que devuelvenVoid(el tipo envoltorio) son consultas, no comandos. - En una clase, no se calcula para las interfaces ni para las clases anónimas o locales. Sí para las abstractas, los enumerados y los records.
- En una interfaz no se calcula para los tipos de anotación; las interfaces locales no tienen fila propia.
Ejemplo
class Counter {
private int n;
Counter() { } // constructor: no cuenta
void increment() { n++; } // comando
void reset() { n = 0; } // comando
int value() { return n; } // consulta
static void log(String s) { } // comando (los estáticos cuentan)
}
Command = 3 y Query = 1.
Cómo interpretarla
No tiene valor bueno ni malo, y Stau Metro no trae umbrales. Un valor alto dice que la clase o interfaz es sobre todo
acción; uno bajo, que declara pocos métodos void. Es útil para ver el equilibrio con las consultas: una clase de
datos casi sin comandos, o un servicio casi sin consultas, son perfiles distintos. Un valor muy alto en una interfaz
puede señalar una interfaz difícil de implementar, pero eso se mide mejor con el
«tamaño de la interfaz».
Relación con otras métricas
- «Número de consultas» (
Query): la otra mitad. Para una clase, comandos + consultas son sus métodos sin contar constructores. - «Tamaño de la clase (operaciones)» (
CSO): cuenta todas las operaciones, también las heredadas y los constructores propios. - «Tamaño de la interfaz (operaciones)» (
ISO): su equivalente para interfaces. - «Número de constructores» (
Cons): lo que queda fuera de comandos y consultas.
En las herramientas
Stau Metro (NumCommandsClass por clase, NumCommandsInterface por interfaz). Solo cuenta lo que la clase o
interfaz declara, por lo que no depende de los supertipos. Un método void de un enumerado cuenta; los métodos que el
lenguaje añade a un enumerado o a un record (como values o los accesores) devuelven un valor, así que no alteran
este recuento.
MetricsReloaded (Command, por clase y por interfaz). Su descripción define el comando como un método que
devuelve void, sin contar los heredados, y su código hace el mismo recuento: excluye los constructores en las clases
y no calcula la métrica para las clases anónimas. A diferencia de Stau Metro, sí da valor a las clases locales.
Referencias
- Fowler, M. «CommandQuerySeparation». https://www.martinfowler.com/bliki/CommandQuerySeparation.html
- Meyer, B. (1988). Object-Oriented Software Construction. Prentice Hall.
- MetricsReloaded, descripción de Number of commands: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/metricsDescriptions/metricsDescriptions/NumCommandsClass.html
- MetricsReloaded, código del cálculo por clase: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/src/com/sixrr/stockmetrics/classCalculators/NumCommandsClassCalculator.java