Número de dependencias de paquete

Actualizado el 15 de noviembre de 2026

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:

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

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 PDcy alto está acoplado hacia arriba, y es candidato a formar ciclos con los paquetes que lo usan;
  • un paquete con PDcy mucho mayor que el resto suele mezclar responsabilidades; dividirlo reparte sus dependencias;
  • un PDcy que 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

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, PDcy puede 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/main y src/test suelen 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