Número de comandos

Actualizado el 15 de noviembre de 2026

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 void es un comando aunque no cambie nada, y uno que devuelve un valor es una consulta aunque cambie estado (como pop en 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 devuelven Void (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

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