Número de paquetes dependientes

Actualizado el 15 de noviembre de 2026

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:

PDpt(Q)=∣{ P≠Q:∃ c∈P, d∈Q, c depende de d }∣\mathit{PDpt}(Q) = \left|\{\, P \ne Q : \exists\, c \in P,\ d \in Q,\ c \text{ depende de } d \,\}\right|

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

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