Número de clases de nivel superior

Actualizado el 15 de noviembre de 2026

Sigla NTC (NTC(rec) en la variante recursiva del paquete)
Aspecto «Tamaño»
Se mide en paquete, módulo, proyecto
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumTopLevelClassesPackage, NumTopLevelClassesRecursivePackage, NumTopLevelClassesModule, NumTopLevelClassesProject

En pocas palabras

Cuenta las clases que se declaran por sí solas en un fichero, sin estar dentro de otra clase. Comparada con el total, dice cuánto del diseño vive en clases anidadas.

Qué mide

La parte «visible» del diseño: las clases que otro paquete puede nombrar sin pasar por una clase contenedora. La diferencia entre «C» y la suma de NTC y «NTI» es lo que está anidado o es local o anónimo.

Cómo se calcula

Se cuenta 1 por cada tipo que no es interfaz y no está dentro de otra clase o interfaz. Entran, por tanto, las clases, los enumerados y los records de nivel superior. Una clase local o anónima declarada dentro de un método tiene una clase contenedora y no es de nivel superior.

Ejemplo

En el ejemplo de «Número de clases», solo Shop no está dentro de otro tipo: NTC = 1, frente a C = 8. Pricing y Tag son interfaces, y NTI tampoco las cuenta porque están anidadas.

Cómo interpretarla

No tiene umbrales. En código convencional, con un tipo por fichero, NTC + NTI queda cerca de C. Una diferencia grande indica mucho uso de tipos anidados, clases anónimas o locales.

Relación con otras métricas

En las herramientas

Stau Metro (NumTopLevelClassesPackage, NumTopLevelClassesRecursivePackage, NumTopLevelClassesModule, NumTopLevelClassesProject). Cuenta los tipos que no son interfaces y no tienen una clase contenedora en el árbol sintáctico. Las anotaciones se consideran interfaces, así que no están. Producción y tests cuentan por igual. Solo ve código Java.

  • Variante recursiva (RecursiveCount). Suma los del paquete y los de todos sus subpaquetes. El paquete por defecto (sin nombre) solo recibe los suyos.
  • Filas. Cada tipo del ámbito crea la fila de su paquete y de su módulo aunque no sea de nivel superior, así que un paquete sin ninguno aparece con 0. El proyecto tiene siempre su fila.