Número de dependencias de paquete
| Sigla | PDcy |
| Aspecto | «Acoplamiento» |
| Se mide en | clase, interfaz |
| Tipo de valor | valor numérico entero, mínimo 0: tamaño de un conjunto de paquetes distintos |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumPackageDependenciesClass, NumPackageDependenciesInterface |
Nota. Existe otra métrica con el mismo nombre y la misma sigla a nivel de paquete: «número de dependencias de paquete (nivel paquete)». Se calculan de forma distinta; ver más abajo.
En pocas palabras
Una clase depende de otras, y esas otras viven en paquetes. PDcy cuenta en cuántos paquetes distintos viven. Una
clase con diez dependencias en un solo paquete está menos dispersa que otra con diez dependencias en diez paquetes:
la segunda tiene que conocer mucho más de la estructura del proyecto.
Qué mide
Mide la dispersión de las dependencias de una clase sobre la estructura de paquetes. Es la proyección de las dependencias de clase sobre los paquetes: a cada clase de la que depende se le sustituye su paquete, y se cuentan los paquetes distintos.
Un valor alto indica que la clase atraviesa muchas partes del diseño, algo habitual en clases de coordinación y problemático en clases de dominio, que deberían apoyarse en pocos conceptos cercanos. Un valor bajo indica que las dependencias están concentradas.
Cómo se calcula
donde es el conjunto de clases de las que depende (ver «Dcy»).
Cada paquete se cuenta una vez, con independencia de cuántas clases de él use . Por tanto
.
Ejemplo
Las dependencias de shop.Order son seis clases:
| Dependencia | Paquete |
|---|---|
BaseEntity |
shop.core |
Customer |
shop.crm |
Item |
shop |
Invoice |
shop.billing |
BillingException |
shop.billing |
Tax |
shop.billing |
Dcy(Order) = 6. Los paquetes distintos son shop.core, shop.crm, shop y shop.billing: PDcy(Order) =
4. Obsérvese que shop, el paquete de la propia clase, entra en la cuenta porque Item está en él (ver
«En las herramientas»).
Cómo interpretarla
No hay umbrales. Úsala junto a «Dcy»:
PDcycercano aDcy: cada dependencia está en un paquete distinto; la clase está muy dispersa.PDcymucho menor queDcy: muchas dependencias en pocos paquetes, normalmente el suyo o uno con el que trabaja de forma natural.PDcyalto en una clase de dominio: probablemente conoce demasiadas partes; revisa si coordina cosas que deberían estar en otra capa.
Relación con otras métricas
- «Número de dependencias» (
Dcy): las clases;PDcylas agrupa por paquete. - «Número de paquetes dependientes» (
PDpt): la dirección opuesta. - «Número de dependencias de paquete (nivel paquete)» (
PDcy): los paquetes de los que depende un paquete entero. - «Acoplamientos eferentes» (
Ce): las clases de otros paquetes de las que dependen las de un paquete.
En las herramientas
Stau Metro (NumPackageDependenciesClass, NumPackageDependenciesInterface). Es el número de paquetes
distintos que contienen una clase de las que cuenta «Dcy» para el elemento. A diferencia de
la métrica del mismo nombre a nivel de paquete, esta puede incluir el propio paquete del elemento si depende
de otra clase declarada en él. Las clases de test no se excluyen aquí: si la clase es de test o depende de una,
cuentan como las demás (a nivel de paquete, en cambio, las dependencias con clases de test no se registran). Solo
se analiza código Java.
Referencias
- Wikipedia, «Coupling (computer programming)»: https://en.wikipedia.org/wiki/Coupling_(computer_programming)