Número de interfaces de anotación

Actualizado el 15 de noviembre de 2026

Sigla ANC (en la variante recursiva del paquete, Can(rec))
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 NumAnnotationClassesPackage, NumAnnotationClassesRecursivePackage, NumAnnotationClassesModule, NumAnnotationClassesProject

En pocas palabras

Cuenta las anotaciones propias que define el código, es decir, las declaraciones @interface. No cuenta los usos de anotaciones, solo sus definiciones.

Qué mide

Cuánto del código es infraestructura declarativa propia: marcadores, metadatos para un framework o para un generador de código. Muchas aplicaciones definen pocas o ninguna; un valor alto es propio de bibliotecas y frameworks que se configuran por anotaciones.

Cómo se calcula

Se cuenta 1 por cada declaración @interface. En el ejemplo de «Número de clases», Tag es la única: ANC = 1.

Cómo interpretarla

No tiene umbrales. Es un dato de caracterización, útil para separar las bibliotecas que definen un lenguaje de anotaciones de las aplicaciones que solo las usan.

Nota. Una anotación cuenta también como interfaz para «IC»: el recuento de interfaces incluye a este.

Relación con otras métricas

En las herramientas

Stau Metro (NumAnnotationClassesPackage, NumAnnotationClassesRecursivePackage, NumAnnotationClassesModule, NumAnnotationClassesProject). Cuenta los tipos de anotación, anidados o no, en producción y en tests. La sigla de la variante recursiva del paquete es Can(rec), no ANC(rec). Solo ve código Java.

  • Variante recursiva (RecursiveCount). Suma las anotaciones del paquete y las de todos sus subpaquetes: p incluye lo de p.q. 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 anotación, así que un paquete sin anotaciones aparece con 0 si declara algún otro tipo. El proyecto tiene siempre su fila.

SonarQube. Incluye las anotaciones en su métrica classes, sin separarlas, según su documentación de métricas.

Referencias