Número de interfaces de anotación
| 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
- «Número de interfaces» (
IC): incluye las anotaciones, de modo queANC≤IC. - «Número de clases» (
C): el total de tipos, anotaciones incluidas. - «Número de interfaces de nivel superior» (
NTI): también cuenta las anotaciones declaradas en el nivel superior.
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:pincluye lo dep.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
- SonarQube, definición de métricas: https://docs.sonarsource.com/sonarqube-server/latest/user-guide/code-metrics/metrics-definition/