Número de constructores
| 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
recordno 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
- «Tamaño de la clase (operaciones)» (
CSO): sí cuenta los constructores que la clase declara entre sus operaciones, así queConses una parte de ese tamaño. - «Número de comandos» y «de consultas»: excluyen los constructores; juntos reparten el resto de los métodos.
- «Número promedio de parámetros» (
OPavg): cuántos parámetros tienen, de media, los métodos de la clase; los constructores escritos en el fuente entran en esa media.
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
- MetricsReloaded, descripción de Number of constructors: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/metricsDescriptions/metricsDescriptions/NumConstructors.html
- MetricsReloaded, código del cálculo: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/src/com/sixrr/stockmetrics/classCalculators/NumConstructorsCalculator.java