Número de módulos
| Sigla | MOD |
| Aspecto | «Tamaño» |
| Se mide en | proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumModulesInProject |
En pocas palabras
Cuenta en cuántas piezas está dividido el proyecto. Un proyecto de un solo módulo da 1; uno multimódulo de Maven o Gradle da tantos como módulos con ficheros tenga.
Qué mide
La división del proyecto en módulos, que es la unidad de construcción y de dependencia más gruesa que ve el IDE. Muchos módulos pequeños suelen indicar una arquitectura por capas o por funciones con fronteras explícitas; pocos módulos grandes, un monolito con las fronteras dentro de los paquetes.
Aquí «módulo» es el del IDE (un módulo de IntelliJ, que el IDE crea al importar un proyecto Maven o Gradle), no un
módulo de la plataforma Java (module-info.java).
Ojo. Un módulo del IDE no siempre es un módulo de la construcción. Al importar un proyecto Gradle, el IDE representa cada conjunto de fuentes (source set:
main,test…) como un módulo propio, agrupado bajo el del proyecto Gradle. Un proyecto Gradle de un solo módulo puede dar así unMODde 2 o 3.
Cómo se calcula
Se cuentan los módulos distintos a los que pertenece al menos un fichero del ámbito analizado:
con los ficheros que recorre el análisis, sean Java o no. Un módulo sin ningún fichero en el ámbito no se cuenta.
Cómo interpretarla
No tiene valor bueno ni malo y no tiene umbrales. Se interpreta con otras cifras:
- el «número de ficheros» y de «paquetes» dividido por
MODda el tamaño medio de un módulo; - en el tiempo, un aumento sostenido puede ser una modularización deliberada o una fragmentación sin criterio; este número por sí solo no las distingue.
Como el ámbito puede ser solo una parte del proyecto, el valor depende de lo que se haya analizado: analizar un directorio da el número de módulos que tocan esos ficheros.
Relación con otras métricas
- «Número de paquetes» (
P): el siguiente nivel de la estructura, dentro de los módulos. - «Número de ficheros» (
FILES): con él, da los ficheros por módulo. - «Número de clases» (
C): con él, da las clases por módulo.
En las herramientas
Stau Metro (NumModulesInProject). Recorre los ficheros del análisis y cuenta cada módulo del IDE la primera vez
que aparece. Cualquier fichero que recorra el análisis sirve, no solo los Java (valen las reglas de
«FILES»): un módulo con solo un .kt y un .xml cuenta 1, y un módulo de documentación sin Java
también cuenta. Un módulo cuyos ficheros están todos excluidos o fuera del ámbito no cuenta.
Referencias
- IntelliJ IDEA, documentación sobre proyectos Gradle («all source sets are represented as separate modules»): https://www.jetbrains.com/help/idea/work-with-gradle-projects.html