Número de dependencias transitivas de paquete
| Sigla | PDcy* |
| Aspecto | «Acoplamiento» |
| Se mide en | paquete |
| Tipo de valor | entero, mínimo 0 |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumTransitiveDependencyPackagesPackage |
En pocas palabras
Cuenta todos los paquetes de los que depende un paquete, directa o indirectamente. Si app usa service, y
service usa model y repo, entonces app depende de tres paquetes aunque solo nombre uno. Es lo que el paquete
arrastra consigo si se reutiliza en otro sitio, y lo que en parte hay que entender para trabajar con él.
Qué mide
El alcance de las dependencias de un paquete. La «dependencia directa» (PDcy) dice
a quién llama un paquete; la transitiva dice de cuánto del sistema depende en último término. Dos paquetes con
PDcy igual a 1 pueden ser muy distintos: uno depende de un paquete de utilidades que no depende de nada; el otro,
de un paquete que arrastra el resto del proyecto.
Cómo se calcula
Es el número de paquetes alcanzables desde P en el grafo de dependencias entre paquetes, siguiendo flechas a
cualquier número de pasos, sin contar el propio P. Es el tamaño de la clausura transitiva del paquete en el
grafo.
Si P está dentro de un ciclo, el recorrido vuelve a él; el propio paquete se descuenta igualmente, y los demás
miembros del ciclo sí cuentan.
Ejemplo
Con los paquetes del ejemplo de «PDcy»:
| Paquete | PDcy |
Alcanza | PDcy* |
|---|---|---|---|
app |
1 | service, model, repo |
3 |
service |
2 | model, repo |
2 |
repo |
1 | model |
1 |
model |
0 | — | 0 |
Con un ciclo: si a depende de b, b de c, c de a y además c de d, cada uno de a, b y c alcanza
a los otros dos y a d, así que vale 3; d vale 0.
Cómo interpretarla
- La diferencia
PDcy* - PDcyes lo que el paquete hereda sin nombrarlo. Una diferencia grande indica que sus dependencias directas son paquetes «pesados». - Un valor cercano al número total de paquetes del proyecto significa que el paquete depende, en la práctica, de todo. Es habitual en el punto de entrada de la aplicación y preocupante en un paquete de dominio.
- Si muchos paquetes comparten casi el mismo valor alto, suele haber un ciclo grande en medio: lo confirma el «número de dependencias cíclicas».
Ojo. Una dependencia transitiva no siempre se nota al cambiar el código: que
appalcancemodela través deserviceno significa que un cambio enmodelrompaapp. La métrica da la cota superior del alcance.
Para profundizar
Las dependencias transitivas entre componentes son la base del diseño físico de Lakos (1996), y de su dependencia acumulada de componentes, que agrega este tipo de recuento sobre todo el sistema. Ver la «dependencia acumulada de componentes».
Una propiedad útil: todos los miembros de un ciclo tienen el mismo valor, porque cada uno alcanza lo mismo que los
demás. Si una tabla muestra un bloque de paquetes con idéntico PDcy*, es probable que formen un ciclo.
Relación con otras métricas
- «Número de dependencias de paquete» (
PDcy): las dependencias directas, un subconjunto de estas. - «Número de paquetes dependientes transitivamente» (
PDpt*): la clausura en la dirección contraria. - «Número de dependencias transitivas» (
Dcy*): la misma medida entre clases. - «Orden de nivel» (
Level): la longitud de la cadena más larga de dependencias, frente a cuántos paquetes hay en ella. - «Dependencia acumulada de componentes» (
CCD): la medida de Lakos que suma estos alcances.
En las herramientas
Stau Metro (NumTransitiveDependencyPackagesPackage). Recorre el mismo grafo que PDcy, con sus mismas reglas
(sin clases de test, sin librerías, solo referencias desde código Java del ámbito, pero con los paquetes de destino
que queden fuera de él), y cuenta los paquetes alcanzables a cualquier distancia, sin el propio. Los paquetes de un
ciclo comparten el mismo valor. Como solo se recorre el código del ámbito, una cadena que siga por código que queda
fuera de él se corta ahí.
Referencias
- Lakos, J. (1996). Large-Scale C++ Software Design. Addison-Wesley.