Número de clases internas
| Sigla | Inner |
| Aspecto | «Tamaño» |
| Se mide en | clase |
| Tipo de valor | valor numérico declarado como puntuación; en la práctica, un recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumInnerClasses |
En pocas palabras
Cuenta los tipos que una clase declara dentro de sí misma. Muestra cuánto se apoya la clase en tipos auxiliares anidados en lugar de repartirlos en ficheros o clases de nivel superior.
Qué mide
El peso de los tipos anidados en una clase. Un par de clases auxiliares (un builder, un nodo de una estructura, una clave) es normal. Muchas pueden indicar un fichero que concentra demasiadas responsabilidades. Cada tipo anidado tiene además su propia fila de métricas, así que el valor de la clase que lo contiene no incluye su tamaño.
Ojo. En la terminología de Java, «clase interna» (inner class) es una clase anidada no estática. Esta métrica usa el nombre en sentido amplio: cuenta los tipos miembro, estáticos o no.
Cómo se calcula
Se cuenta 1 por cada tipo miembro declarado directamente en la clase: clase, interfaz, enumerado, record o anotación, estático o no.
- Solo un nivel: la clase anidada dentro de otra anidada se cuenta en esta última, no en la exterior.
- No cuentan las clases locales (declaradas en un método) ni las anónimas.
- Se calcula para clases con nombre, incluidas las anidadas, abstractas, los enumerados y los records; no para interfaces.
Ejemplo
class Calc {
static int twice(int n) { return n * 2; }
static class Inner { int v; void bump() { v++; } } // 1: cuenta
int run(int n) {
class Local { int z; } // local: no cuenta
Runnable r = new Runnable() { public void run() { } }; // anónima: no cuenta
return n;
}
}
Calc vale 1 e Inner vale 0. Es, en esencia, la clase de los datos de prueba del proyecto, que fijan esos valores.
Cómo interpretarla
Stau Metro no trae umbral. Un 0 es lo más común. Un valor alto no es un defecto por sí mismo: las clases con muchos tipos pequeños fuertemente ligados a ella (un visitor con sus nodos, una máquina de estados con sus estados) son legítimas. Pregúntate si esos tipos los usa alguien más; si sí, probablemente merecen salir a nivel superior.
Relación con otras métricas
- «Número de clases» (
C): cuenta todas las clases de un paquete, módulo o proyecto, anidadas incluidas. - «Número de clases de nivel superior» (
NTC): la contrapartida, las que no están anidadas. - «Número de clases anónimas» (
AnoC): las que esta métrica deja fuera.
En las herramientas
Stau Metro (NumInnerClasses, a nivel de clase). Cuenta lo que el IDE devuelve como clases internas de la
clase: los tipos miembro declarados directamente. Como la ayuda del plugin, la cuenta se limita a un nivel de
anidamiento. Una clase local no tiene fila propia, así que tampoco se mide lo que declare dentro.
MetricsReloaded (Inner). Su descripción la define como el número de clases o interfaces internas de cada clase,
sin las anónimas, y su código hace el mismo recuento de tipos miembro directos. A diferencia de Stau Metro, también
da valor a las clases locales.
Referencias
- MetricsReloaded, descripción de Number of inner classes: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/metricsDescriptions/metricsDescriptions/NumInnerClasses.html
- MetricsReloaded, código del cálculo: https://github.com/BasLeijdekkers/MetricsReloaded/blob/master/stockmetrics/src/com/sixrr/stockmetrics/classCalculators/NumInnerClassesCalculator.java