Número de dependientes

Actualizado el 15 de noviembre de 2026

Sigla Dpt
Aspecto «Acoplamiento»
Se mide en clase, interfaz
Tipo de valor valor numérico entero, mínimo 0: tamaño de un conjunto de clases distintas
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumDependentsClass, NumDependentsInterface

En pocas palabras

Cuenta cuántas otras clases usan a esta. Un número alto dice que muchas piezas se apoyan en ella: tocarla es arriesgado y conviene que sea estable. Un cero dice que ninguna clase analizada la usa: puede ser el punto de entrada de la aplicación, una clase que se carga por configuración o una que sobra.

Qué mide

Mide el acoplamiento de entrada de un tipo, también llamado fan-in o acoplamiento aferente: cuántos elementos del código dependen de él. Es el reverso de «Dcy»: si AA depende de BB, BB tiene un dependiente más.

La pregunta que contesta no es «¿está bien diseñada?» sino «¿cuánto se nota un cambio aquí?». Por eso no tiene dirección buena o mala. Una clase muy usada es una buena abstracción si es pequeña y estable (una interfaz del dominio, un tipo de valor) y un problema si es grande y cambia a menudo.

Cómo se calcula

Dpt(C)=∣{ D≠C∣D depende de C }∣Dpt(C) = |\{\, D \neq C \mid D \text{ depende de } C \,\}|

Se cuenta una vez cada clase dependiente, con independencia del número de referencias. Cuáles son las relaciones que hacen que DD «dependa» de CC son las mismas que cuenta «Dcy», leídas al revés.

Ejemplo

Con estas tres clases:

class Report { Customer c; }           // Report depende de Customer
class Mailer { void send(Customer c) {} }   // Mailer depende de Customer
class Customer { }

Dpt(Customer) = 2 (Report y Mailer) y Dpt(Report) = Dpt(Mailer) = 0. Si Mailer usara Customer en diez sitios, el valor seguiría siendo 2.

Cómo interpretarla

No hay umbrales: ni un valor alto ni uno bajo son buenos en sí mismos.

  • Valor alto. La clase es un soporte del sistema. Hazla pequeña, estable y apoyada en abstracciones: un cambio en ella llega a muchas clases (el alcance total lo da «Dpt*»). A nivel de paquete, la «inestabilidad» combina esta idea con la de salida.
  • Valor cero. Esperable en una clase de arranque, un controlador o una clase de test. Si no es ninguna de esas, es candidata a código muerto (aunque la usen por reflexión o la cargue un marco: la métrica no ve eso).
  • Combinada con Dcy. Muchos dependientes y pocas dependencias señalan una base estable; pocos dependientes y muchas dependencias, una clase de la capa alta; muchos de las dos cosas, un nodo por el que pasa todo y que merece una revisión.

Para profundizar

Dpt es el fan-in a nivel de clase; el fan-in y el fan-out son también los ingredientes de la «complejidad de flujo de información». Una clase con muchos dependientes tiene un coste de cambio alto, pero el riesgo real depende de que el cambio rompa el contrato público. Añadir un método concreto rara vez afecta a quien la usa; añadir un método abstracto a una clase o a una interfaz obliga a cambiar todas sus subclases o implementaciones.

Cuenta dependientes, no usos: una sola referencia de un dependiente basta. Y cuenta código analizado: los usuarios que están fuera del alcance (otro repositorio, otro módulo no incluido) no figuran.

Relación con otras métricas

En las herramientas

Stau Metro (NumDependentsClass, NumDependentsInterface). Es el recuento inverso del que hace «Dcy»: cuenta las clases distintas que, por cualquiera de las relaciones que allí se enumeran, hacen referencia a este elemento. En una interfaz, las clases que la implementan son dependientes suyos. Una clase anónima o local aporta sus referencias a la clase que la contiene, que es la que cuenta como dependiente. Las clases de test cuentan como dependientes como las demás: si el test está en el ámbito analizado, una clase de producción usada solo por su test tiene Dpt = 1. Solo cuentan los dependientes de los ficheros Java del ámbito analizado; un uso desde código que no se analiza no se ve.

Referencias