Acoplamientos eferentes

Actualizado el 15 de noviembre de 2026

Sigla Ce
Aspecto «Acoplamiento»
Se mide en paquete
Tipo de valor entero, mínimo 0
Dirección informativa: ni alto ni bajo es mejor
Origen Robert C. Martin, 1994
Familia «Métricas de paquetes de Martin»
Stau Metro EfferentCoupling

En pocas palabras

Cuenta cuántas clases del paquete usan algo de otros paquetes. Cada una de ellas puede tener que cambiar cuando cambia lo que usa. Un paquete con muchas clases que miran hacia fuera está expuesto a cambios que no controla.

Qué mide

La dependencia del paquete respecto al resto del sistema. Eferente significa «que sale»: son las dependencias que parten del paquete hacia otros.

Es la segunda entrada de la «inestabilidad» de Martin, junto con los «acoplamientos aferentes» (Ca). Un paquete con Ce alto y Ca bajo es inestable: depende de mucho y nada depende de él, así que es fácil de cambiar y a menudo tiene que hacerlo. No es un defecto: los paquetes de más alto nivel (la aplicación, la interfaz de usuario) son inestables por diseño.

Cómo se calcula

La definición original de Martin (1994):

Ce: Efferent Couplings: The number of classes inside this category that depend upon classes outside this categories. [sic]

Es decir:

Ce(P)=∣{ c∈P:c depende de alguna clase de fuera de P }∣\mathit{Ce}(P) = \left|\{\, c \in P : c \text{ depende de alguna clase de fuera de } P \,\}\right|

Se cuentan las clases del propio paquete que tienen alguna dependencia externa, no el número de clases externas que se usan. Una clase que usa diez clases de fuera cuenta una vez; una clase que no usa nada de fuera no cuenta.

Ojo. La asimetría sorprende: Ca cuenta clases de fuera y Ce cuenta clases de dentro. Por eso Ce(P) no es la suma de los Ca que P provoca en otros paquetes. Muchas herramientas no siguen esta definición (ver «En las herramientas»).

Ejemplo

Con los paquetes del ejemplo de «Ca»:

package service;
public class OrderService { model.Order o; model.Customer c; }   // usa clases de fuera: cuenta 1
public class PriceCalculator { model.Order o; }                  // usa clases de fuera: cuenta 1
public class Util { PriceCalculator p; }                         // solo usa su paquete: no cuenta

(Cada clase pública va en su propio fichero; aquí se muestran juntas.)

Paquete Clases que usan algo de fuera Ce
service OrderService, PriceCalculator 2
app Main 1
model — 0

service depende de un único paquete (model) y de dos clases de él, pero su Ce es 2 porque son dos las clases de service que miran hacia fuera. Una medida que cuente paquetes, como la de JDepend, daría 1 por model, más los paquetes de la JDK que no se filtren (JDepend no filtra ninguno por defecto).

Cómo interpretarla

No tiene umbral de referencia, y Martin no lo valora solo. Las lecturas útiles salen de compararlo:

  • Ce alto con Ca bajo: paquete inestable, normal en la capa de más arriba. Conviene que sea concreto y que nadie dependa de él.
  • Ce alto con Ca alto: paquete muy usado que a su vez depende de mucho. Cualquier cambio de fuera le llega y él lo propaga. Es el caso que más cuesta mantener; dividirlo o invertir dependencias suele ayudar.
  • Ce igual a 0: el paquete no usa nada del resto del ámbito (sí puede usar la JDK y librerías). Es lo esperado en un paquete de modelo o de interfaces.
  • Ce cercano al número de clases del paquete: casi todas sus clases miran fuera. Puede que el paquete sea una fachada, o que sus clases estén mal agrupadas y pertenezcan a los paquetes que usan.

Para profundizar

Qué cuenta como «fuera». La definición de Martin no dice nada de las librerías. Si se cuentan la biblioteca estándar y las de terceros, casi todas las clases que usen un String o una colección dependen «de fuera» y el valor se acerca al número de clases del paquete; si se excluyen, Ce solo ve las dependencias dentro del sistema. Antes de comparar valores de dos herramientas, comprueba qué hace cada una.

Tres definiciones con el mismo nombre. Bajo la sigla Ce circulan al menos tres medidas: las clases de dentro que dependen de fuera (Martin), los paquetes de los que se depende (JDepend) y los tipos de fuera que se usan (NDepend en el nivel de ensamblado). Dan valores distintos en cuanto un paquete tiene varias clases o depende de varios paquetes, y con ellas cambia también la inestabilidad que se calcula a partir de Ce.

Relación con otras métricas

En las herramientas

Stau Metro (EfferentCoupling). Cuenta las clases del paquete que dependen de al menos una clase de fuera, con los tipos de referencia del «número de dependencias». Reglas:

  • «clase» incluye interfaces, enumerados, records y anotaciones;
  • cada clase con nombre cuenta por separado, también las anidadas: si A y su clase anidada A.Inner usan algo de fuera, suman 2; las anónimas y locales cuentan como parte de la clase que las contiene;
  • las clases de test no cuentan, ni como parte del paquete ni como clases de fuera;
  • como en Ca, solo cuentan como clases de fuera las clases Java del ámbito analizado: no cuentan las librerías, ni las clases del proyecto que quedan fuera del ámbito, ni las clases Kotlin;
  • tienen valor los paquetes con al menos una clase que no sea de test;
  • se usa también para calcular Instability y Distance.

JDepend. Define Ce como «el número de otros paquetes de los que dependen las clases del paquete»: cuenta paquetes. Es la idea de PDcy, pero JDepend lee el bytecode y, si no se le configuran filtros, cuenta también los paquetes de la JDK y de las librerías.

NDepend. En el nivel de ensamblado, Ce es «el número de tipos de fuera del ensamblado que usan los tipos de dentro»: cuenta las clases externas, no las internas. En el nivel de namespace (NamespaceCe) cuenta los namespaces de los que depende directamente.

Referencias