Número de paquetes dependientes
| Sigla | PDpt |
| Aspecto | «Acoplamiento» |
| Se mide en | paquete |
| Tipo de valor | entero, mínimo 0 |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumDependentPackagesPackage |
En pocas palabras
Cuenta cuántos paquetes distintos usan algo de este paquete. Si service y repo usan clases de model, model
vale 2. Dice a cuántos sitios afectaría un cambio que rompa la compatibilidad del paquete.
Qué mide
El acoplamiento de entrada de un paquete, contado en paquetes. Es la medida de su responsabilidad hacia el resto del sistema: cuantos más paquetes dependen de él, más caro es cambiar su interfaz pública y más cuidado hay que poner en que sea estable.
No es ni bueno ni malo en sí. Un paquete de modelo o de utilidades está para que lo usen muchos; un paquete de interfaz de usuario con muchos dependientes, en cambio, es una señal de capas invertidas.
Cómo se calcula
Sobre el mismo grafo de paquetes que el «número de dependencias de paquete» (una flecha
de P a Q si alguna clase de P depende de alguna clase de Q, con P distinto de Q), el valor es el número
de flechas que llegan al paquete:
Ejemplo
Con los cuatro paquetes del ejemplo de «PDcy» (app usa service; service usa
model y repo; repo usa model):
| Paquete | Lo usan | PDpt |
|---|---|---|
model |
service, repo |
2 |
repo |
service |
1 |
service |
app |
1 |
app |
— | 0 |
Cuando todos los paquetes están en el ámbito analizado, la suma de PDpt es igual a la suma de PDcy (4 en este
caso): las dos cuentan las mismas flechas, una por su origen y otra por su destino.
Cómo interpretarla
- Valor alto en un paquete de bajo nivel (modelo, utilidades, API): esperado. Lo que importa es que ese paquete sea estable y, a ser posible, abstracto; es la idea que formalizan la «inestabilidad» y la «distancia a la secuencia principal».
- Valor alto en un paquete de alto nivel o con mucha lógica concreta que cambia a menudo: cada cambio se propaga a muchos sitios. Extraer una interfaz estable en un paquete aparte reduce el impacto.
- Valor 0: nadie de dentro del ámbito lo usa. Es normal en un punto de entrada (
main, controladores); en otro paquete puede ser código muerto, o código que solo usan los tests.
Para saber hasta dónde llega un cambio hay que mirar el «número de paquetes dependientes transitivamente».
Relación con otras métricas
- «Número de dependencias de paquete» (
PDcy): la dirección contraria sobre el mismo grafo. - «Número de paquetes dependientes transitivamente» (
PDpt*): el alcance completo de un cambio; nunca es menor quePDpt. - «Acoplamientos aferentes» (
Ca): el acoplamiento de entrada contado en clases, como lo definió Martin.PDptcuenta lo que JDepend llamaCa. - «Número de paquetes dependientes» (
PDpt, nivel de clase): la misma idea para una clase sola; comparten la sigla.
En las herramientas
Stau Metro (NumDependentPackagesPackage). Cuenta los paquetes distintos, aparte del propio, que contienen una
clase que depende de alguna clase del paquete. Reglas:
- solo cuentan como dependientes las clases Java del ámbito analizado: un paquete del proyecto que queda fuera del ámbito, o un fichero Kotlin que use el paquete, no suma;
- no cuentan las clases de test, ni como origen ni como destino de la dependencia;
- los tipos de referencia son los del «número de dependencias»; las clases anónimas y locales cuentan como parte de la clase que las contiene;
- un paquete se identifica por su nombre, aunque esté repartido en varios módulos;
- tienen valor todos los paquetes con algún fichero Java en el ámbito, también los que solo contienen tests (con valor 0).
JDepend. Su Ca (afferent couplings) cuenta lo mismo, paquetes: «el número de otros paquetes que dependen de
clases del paquete». Lee el bytecode, y sus reglas sobre qué es una dependencia no son las mismas.
NDepend. Su NamespaceCa es el número de namespaces que dependen directamente de uno dado.
Referencias
- JDepend, documentación: https://github.com/clarkware/jdepend/blob/master/docs/JDepend.html
- NDepend, métricas de código: https://www.ndepend.com/Docs/Code-Metrics