Número de interfaces de nivel superior
| Sigla | NTI (NTI(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 | NumTopLevelInterfacesPackage, NumTopLevelInterfacesRecursivePackage, NumTopLevelInterfacesModule, NumTopLevelInterfacesProject |
En pocas palabras
Cuenta las interfaces que se declaran por sí solas en un fichero, sin estar dentro de otra clase o interfaz. Comparada con el total de interfaces, dice cuántas son contratos independientes y cuántas están escondidas dentro de una clase.
Qué mide
La parte pública y reutilizable de los contratos del diseño. Las interfaces anidadas suelen ser un detalle de la clase que las contiene (un listener, un callback propio), mientras que las de nivel superior son la frontera que otros paquetes suelen implementar.
Cómo se calcula
Se cuenta 1 por cada interfaz que no está dentro de otra clase o interfaz. Como el IDE trata las anotaciones como
interfaces, las @interface de nivel superior también cuentan.
Ejemplo
En el ejemplo de «Número de clases», Pricing y Tag están dentro de Shop: NTI = 0 aunque
IC = 2.
Cómo interpretarla
No tiene umbrales. Compárala con el «número de interfaces»: la diferencia son las interfaces anidadas. Un valor bajo con muchas anidadas indica contratos pensados para uso interno.
Relación con otras métricas
- «Número de interfaces» (
IC): el total;NTI≤IC. - «Número de clases de nivel superior» (
NTC): lo mismo para las clases. - «Número de interfaces de anotación» (
ANC): las anotaciones de nivel superior están enNTI.
En las herramientas
Stau Metro (NumTopLevelInterfacesPackage, NumTopLevelInterfacesRecursivePackage,
NumTopLevelInterfacesModule, NumTopLevelInterfacesProject). Cuenta los tipos que el IDE considera interfaces
(anotaciones incluidas, como un test de valores de referencia fija para IC) y que no tienen un tipo contenedor.
El texto de ayuda del plugin no menciona las anotaciones. Producción y tests cuentan por igual. Solo ve código Java.
- Variante recursiva (
RecursiveCount). Suma las del paquete y las de todos sus subpaquetes. El paquete por defecto (sin nombre) solo recibe las suyas. - Filas. Cada tipo del ámbito crea la fila de su paquete y de su módulo aunque no sea una interfaz de nivel superior, así que un paquete sin ninguna aparece con 0. El proyecto tiene siempre su fila.