Número de constructores

Actualizado el 15 de noviembre de 2026

Sigla Cons
Aspecto «Tamaño»
Se mide en clase
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumConstructors

En pocas palabras

Cuenta los constructores que una clase declara de forma explícita. Un valor de 1 significa que hay una sola manera de crear un objeto; valores altos, que hay varias.

Qué mide

La variedad de formas de construir una clase. Muchos constructores suelen indicar muchas combinaciones de estado inicial, y a menudo una clase que hace demasiado o que arrastra una cadena de constructores sobrecargados para parámetros opcionales. Un 0 no significa que no se pueda instanciar: Java añade un constructor por defecto cuando no se escribe ninguno, y esta métrica no lo cuenta.

Cómo se calcula

Se cuenta 1 por cada constructor que está escrito en el código fuente de la clase.

  • El constructor por defecto implícito no cuenta. Una clase sin constructores escritos vale 0.
  • El constructor canónico implícito de un record no cuenta; uno escrito a mano (incluida la forma compacta) sí.
  • Los constructores de las clases anidadas cuentan en esas, no en la que las contiene.
  • Los constructores no se heredan, así que solo cuentan los de la propia clase.
  • Se calcula para clases con nombre, incluidas las abstractas, los enumerados y los records; no para interfaces ni para clases anónimas o locales.

Ejemplo

class Money {
    private final long cents;
    private final String currency;

    Money(long cents) { this(cents, "EUR"); }          // 1
    Money(long cents, String currency) {               // 2
        this.cents = cents;
        this.currency = currency;
    }
    static Money of(long cents) { return new Money(cents); }   // método de factoría: no cuenta
}

Cons = 2. La factoría estática crea objetos pero no es un constructor.

Cómo interpretarla

Stau Metro no trae umbrales. Una clase con un solo constructor es la forma más fácil de entender. Si el valor crece, considera si los constructores sobrecargados se pueden sustituir por métodos de factoría con nombre o, si los parámetros son opcionales, por un builder. Para clases sencillas de datos, varios constructores son normales. Y un 0 es lo esperado en clases con constructor por defecto, enumerados sin constructor y muchos records.

Relación con otras métricas

En las herramientas

Stau Metro (NumConstructors, a nivel de clase). Cuenta únicamente los constructores presentes en el código fuente; los que el compilador o el IDE sintetizan (por defecto o canónico de un record) no aparecen. Los tests del proyecto fijan un 0 para un enumerado y un record sin constructores propios.

MetricsReloaded (Cons). Su descripción la define como el número de constructores declarados en la clase, sin contar el constructor por defecto (una clase sin constructores vale 0). Su código toma los constructores que devuelve el IDE, sin el filtro de Stau Metro para los que no están escritos en el fuente.

Referencias