Acoplamientos eferentes
| 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:
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:
Cacuenta clases de fuera yCecuenta clases de dentro. Por esoCe(P)no es la suma de losCaquePprovoca 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:
Cealto conCabajo: paquete inestable, normal en la capa de más arriba. Conviene que sea concreto y que nadie dependa de él.Cealto conCaalto: 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.Ceigual 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.Cecercano 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
- «Acoplamientos aferentes» (
Ca): la otra mitad; dependencias que llegan al paquete. - «Inestabilidad» (
I): se calcula comoCe / (Ca + Ce); unCealto la sube. - «Distancia a la secuencia principal» (
D): combina la inestabilidad con la «abstracción». - «Número de dependencias de paquete» (
PDcy): la misma dirección contada en paquetes; es lo que JDepend llamaCe. - «Número de dependencias» (
Dcy): el acoplamiento de salida de una clase sola.
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
Ay su clase anidadaA.Innerusan 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
InstabilityyDistance.
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
- Martin, R. C. (1994). «OO Design Quality Metrics: An Analysis of Dependencies». Artículo publicado en el grupo de
noticias
comp.lang.c++, agosto de 1994. https://groups.google.com/d/msg/comp.lang.c++/-/ouRSXPUpybkJ - 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