Número de dependencias 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 | NumDependencyPackagesPackage |
En pocas palabras
Cuenta de cuántos otros paquetes del proyecto usa algo un paquete. Si alguna clase de service usa una clase de
model y otra usa una de repo, el paquete service vale 2. Dice qué te llevarías detrás si quisieras sacar ese
paquete a una librería aparte.
Qué mide
El acoplamiento de salida de un paquete, contado en paquetes y no en clases. Cada paquete del que depende es un
sitio desde el que le pueden llegar cambios: si model cambia una firma, service puede dejar de compilar.
Contar paquetes en vez de clases da una vista de arquitectura: no importa si service usa una clase de model o
veinte, la relación entre los dos paquetes existe igual. Para el detalle por clases están los
«acoplamientos eferentes» (Ce).
Cómo se calcula
Se construye el grafo de dependencias entre paquetes: hay una flecha de P a Q cuando al menos una clase de P
hace referencia a al menos una clase de Q, con Q distinto de P. El valor es el número de flechas que salen de
P:
Qué cuenta como «depender» es lo mismo que en el «número de dependencias» de una clase: tipos de
campos, parámetros, variables y valores devueltos, superclases e interfaces, llamadas, creación de objetos,
anotaciones, conversiones, instanceof, etc.
Ejemplo
// fichero app/Main.java
package app;
public class Main { service.OrderService s; } // app -> service
// fichero service/OrderService.java
package service;
public class OrderService { model.Order o; repo.OrderRepository r; } // service -> model, service -> repo
// fichero repo/OrderRepository.java
package repo;
public class OrderRepository { model.Order o; } // repo -> model
// fichero model/Order.java
package model;
public class Order { String id; } // String es de la JDK: no cuenta
| Paquete | Depende de | PDcy |
|---|---|---|
app |
service |
1 |
service |
model, repo |
2 |
repo |
model |
1 |
model |
— | 0 |
Cómo interpretarla
No tiene umbral: un paquete de orquestación (app) depende por naturaleza de muchos otros, y uno de dominio
(model) debería depender de pocos. Lo que conviene mirar es si el valor encaja con el papel del paquete:
- un paquete que se supone de bajo nivel (utilidades, modelo) con
PDcyalto está acoplado hacia arriba, y es candidato a formar ciclos con los paquetes que lo usan; - un paquete con
PDcymucho mayor que el resto suele mezclar responsabilidades; dividirlo reparte sus dependencias; - un
PDcyque crece entre versiones indica que el paquete va absorbiendo conocimiento de todo el sistema.
Compáralo con el «número de dependencias transitivas de paquete»: un PDcy
de 2 con un PDcy* de 40 significa que esas dos dependencias arrastran medio proyecto.
Relación con otras métricas
- «Número de paquetes dependientes» (
PDpt): la dirección contraria sobre el mismo grafo. - «Número de dependencias transitivas de paquete» (
PDcy*): la misma pregunta siguiendo las flechas a cualquier distancia; nunca es menor quePDcy. - «Acoplamientos eferentes» (
Ce): el acoplamiento de salida del paquete contado en clases, como lo definió Martin. - «Número de dependencias de paquete» (
PDcy, nivel de clase): la misma idea para una clase sola; comparten la sigla. - «Número de dependencias cíclicas» (
Cyclic): dice si alguna de esas flechas vuelve.
En las herramientas
Stau Metro (NumDependencyPackagesPackage). Cuenta los paquetes distintos, aparte del propio, que contienen una
clase de la que depende alguna clase del paquete. Reglas:
- solo se analiza código Java; las referencias que salen de ficheros Kotlin no se ven;
- las clases de librerías (compiladas, incluida la JDK) no cuentan; las clases de código fuente del proyecto sí,
aunque queden fuera del ámbito analizado (a diferencia de
Ce, que solo cuenta clases del ámbito). Con un ámbito parcial,PDcypuede contar paquetes que no tienen fila en los resultados; - no cuentan las clases de test: una referencia desde o hacia una clase de una raíz de test no crea flecha entre
paquetes. Como
src/mainysrc/testsuelen compartir nombres de paquete, esto evita que un test cree un ciclo falso; - un paquete se identifica por su nombre: el mismo paquete repartido en dos módulos es un solo nodo;
- las clases anónimas y locales cuentan como parte de la clase que las contiene;
- tienen valor todos los paquetes con algún fichero Java en el ámbito, también los que solo contienen tests o un
package-info.java(con valor 0, porque sus tests no crean flechas).
JDepend. Su Ce (efferent couplings) cuenta lo mismo, paquetes: «el número de otros paquetes de los que
dependen las clases del paquete». Fíjate en que no coincide con el Ce de Martin, que cuenta clases. JDepend lee el
bytecode y no filtra por defecto ningún paquete, así que, sin configurarlo, también cuenta los de la JDK y los de
las librerías.
NDepend. Su NamespaceCe es el número de namespaces de los que un namespace depende directamente, la medida
equivalente en .NET.
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