Acoplamientos aferentes

Actualizado el 15 de noviembre de 2026

Sigla Ca
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 AfferentCoupling

En pocas palabras

Cuenta cuántas clases de otros paquetes usan algo de este paquete. Cada una de esas clases es alguien que puede romperse si el paquete cambia. Un paquete con muchos usuarios es un paquete del que el resto del sistema depende, y eso obliga a cambiarlo con cuidado.

Qué mide

La responsabilidad del paquete hacia el resto del sistema: cuánto código ajeno descansa sobre él. Aferente significa «que llega»: son las dependencias que entran en el paquete.

Martin no la propuso para juzgarla sola, sino como una de las dos entradas de la «inestabilidad», junto con los «acoplamientos eferentes» (Ce, las dependencias que salen). Un paquete con Ca alto y Ce bajo es estable: mucho depende de él y él depende de poco, así que tiene pocas razones para cambiar y muchas para no hacerlo.

Para quien empieza. «Estable» aquí no quiere decir «que funciona bien», sino «difícil de cambiar», porque mucha gente lo usa. Es una descripción, no un elogio.

Cómo se calcula

La definición original de Martin (1994), sobre lo que él llamaba categorías de clases (en Java, paquetes):

Ca: Afferent Couplings: The number of classes outside this category that depend upon classes within this category.

Es decir:

Ca(P)=∣{ c∉P:c depende de alguna clase de P }∣\mathit{Ca}(P) = \left|\{\, c \notin P : c \text{ depende de alguna clase de } P \,\}\right|

Se cuentan clases, no referencias ni paquetes: una clase de fuera cuenta una vez, aunque use diez clases del paquete y lo haga en cien sitios. Las dependencias entre clases del propio paquete no cuentan.

Ejemplo

// fichero model/Order.java
package model;
public class Order {}

// fichero model/Customer.java
package model;
public class Customer {}

// fichero service/OrderService.java
package service;
public class OrderService { model.Order o; model.Customer c; }   // usa model (dos clases: cuenta una vez)

// fichero service/PriceCalculator.java
package service;
public class PriceCalculator { model.Order o; }                  // usa model

// fichero service/Util.java
package service;
public class Util { PriceCalculator p; }                         // mismo paquete: no cuenta

// fichero app/Main.java
package app;
public class Main { service.OrderService s; }                    // usa service
Paquete Clases de fuera que lo usan Ca
model OrderService, PriceCalculator 2
service Main 1
app — 0

OrderService usa dos clases de model, pero es una sola clase dependiente. Util usa PriceCalculator, pero los dos están en service: no es acoplamiento aferente.

Cómo interpretarla

No tiene umbral de referencia. El valor depende del papel del paquete:

  • Ca alto en un paquete de base (modelo, interfaces, utilidades): normal. Pide que el paquete sea estable y, si cambia a menudo, que sea abstracto, para que los cambios queden en las implementaciones. Es lo que mide la «distancia a la secuencia principal».
  • Ca alto en un paquete concreto y volátil (lógica de negocio que se toca cada semana): cada cambio afecta a muchas clases de fuera. Extrae a un paquete aparte la parte que los demás usan, o haz que dependan de interfaces.
  • Ca igual a 0: nadie del ámbito lo usa. Es lo esperado en un punto de entrada o en un paquete de controladores; en otro paquete puede indicar código muerto o que solo usan los tests (que aquí no cuentan).

Ojo. Ca cuenta clases y no paquetes. Un único paquete de fuera con cuarenta clases que usan el tuyo da 40; cuarenta paquetes con una clase cada uno, también. Para saber cuántos paquetes hay detrás, mira el «número de paquetes dependientes».

Para profundizar

Qué es una dependencia. Martin habla de «depender» sin enumerar relaciones; en el mismo artículo trata la herencia como dependencia. Las herramientas eligen qué referencias cuentan (tipos de campos y parámetros, llamadas, herencia, anotaciones…), y por eso los valores de distintas herramientas no son comparables sin más.

Clases o paquetes. La definición de Martin cuenta clases, pero JDepend, una de las herramientas más usadas para estas métricas en Java, cuenta paquetes; NDepend cuenta tipos en el nivel de ensamblado y namespaces en el de namespace. Cuando leas un Ca publicado, comprueba en qué unidad está.

Qué entra en el paquete. Las clases anidadas, las anónimas y las de test se tratan de forma distinta según la herramienta. Contar cada clase anidada como dependiente aparte, por ejemplo, sube el valor respecto a una herramienta que solo vea clases de primer nivel.

Relación con otras métricas

En las herramientas

Stau Metro (AfferentCoupling). Cuenta las clases distintas de fuera del paquete que dependen de al menos una clase de dentro, 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 el paquete, suman 2. Las clases anónimas y locales cuentan como parte de la clase que las contiene;
  • las clases de test no cuentan, ni como dependientes ni como parte del paquete;
  • solo cuentan como dependientes las clases Java del ámbito analizado: una clase del proyecto fuera del ámbito, o una clase Kotlin, no suma;
  • tienen valor los paquetes con al menos una clase que no sea de test; un paquete que solo contiene tests no aparece;
  • se usa también para calcular Instability y Distance.

JDepend. Define Ca como «el número de otros paquetes que dependen de clases del paquete»: cuenta paquetes, no clases. Es la idea de PDpt, aunque JDepend lee el bytecode y sus reglas sobre qué es una dependencia no son las mismas.

NDepend. En el nivel de ensamblado, Ca es «el número de tipos de fuera del ensamblado que dependen de tipos de dentro», la definición de Martin; en el nivel de namespace (NamespaceCa) cuenta los namespaces que dependen directamente de él.

Referencias