Número de ficheros XML
| Sigla | XML |
| Aspecto | «Tamaño» |
| Se mide en | módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumXMLFilesModule, NumXMLFilesProject |
En pocas palabras
Cuenta los ficheros XML de un módulo o de todo el proyecto. Sirve para saber cuánta parte del proyecto no es código sino configuración, descriptores o recursos escritos en XML.
Qué mide
El peso del XML en el proyecto, en número de ficheros. En un proyecto Java el XML suele ser configuración (Maven, Spring, descriptores de despliegue, logging), recursos de interfaz o datos de test. Ninguna otra métrica de código lo ve: las de clases, métodos y paquetes solo miran el código Java.
Cómo se calcula
Se cuenta 1 por cada fichero XML dentro del ámbito analizado. No importan ni su tamaño ni su contenido; para eso están las «líneas de XML».
Cómo interpretarla
No tiene un valor bueno ni malo, y por eso no tiene umbrales. Es útil comparada con otras cifras:
- frente al «número de ficheros» y al «número de ficheros Java», dice qué parte del módulo es configuración y cuál es código;
- entre módulos, señala los que son sobre todo recursos o descriptores;
- a lo largo del tiempo, muestra si la configuración crece más deprisa que el código, o si una migración de XML a anotaciones o a código avanza.
Un módulo con muchos más ficheros XML que Java merece una mirada: parte de su lógica puede estar en la configuración, donde las demás métricas no llegan.
Relación con otras métricas
- «Líneas de XML» (
L(XML)): el mismo censo medido en líneas; juntas dan el tamaño medio de un fichero XML. - «Número de ficheros» (
FILES): el total del que esta métrica es una parte. - «Número de ficheros Java» (
J), «Kotlin» (KT) y «HTML» (HTML): los otros recuentos por tecnología.
En las herramientas
Stau Metro (NumXMLFilesModule por módulo, NumXMLFilesProject para el proyecto). Cuenta los ficheros que el
IDE reconoce como de tipo XML: los .xml y los de otras extensiones asociadas por defecto a ese tipo, como .xsd,
.xsl, .xslt, .wsdl, .tld o .fxml. Un fichero HTML o XHTML no cuenta aquí, aunque sea XML bien formado:
son otros tipos de fichero. Se cuentan los ficheros del ámbito analizado estén o no en una raíz de fuentes, con las
reglas de «FILES» sobre qué ficheros recorre el análisis (no entran los excluidos ni los que quedan
fuera del contenido de los módulos). Un módulo con ficheros pero sin XML aparece con valor 0.
Referencias
- IntelliJ Platform, registro del tipo de fichero XML (
XmlFileType, extensionesant;fxml;jhm;jnlp;jrxml;rng;tld;wsdl;xml;xsd;xsl;xslt;xul), en el código fuente de la plataforma.