Factor de acoplamiento

Actualizado el 15 de noviembre de 2026

Sigla CF (en algunos textos, COF)
Aspecto «Acoplamiento»
Se mide en proyecto
Tipo de valor proporción, que se muestra como porcentaje (0 % a 100 %)
Dirección más alto es peor
Origen Fernando Brito e Abreu y Rogério Carapuça, 1994; definición revisada en 1995
Familia «Métricas MOOD»
Stau Metro CouplingFactorProject

En pocas palabras

Mira todas las parejas de clases del proyecto y se pregunta en cuántas la primera usa a la segunda. Si ninguna clase usa a otra, vale 0 %; si cada clase usara a todas las demás, valdría 100 %. Un valor alto dice que el proyecto es una madeja: cuesta separar una parte sin arrastrar el resto.

Qué mide

Mide la densidad de acoplamiento del sistema entero. Una clase está acoplada a otra cuando la usa: declara un campo de su tipo, llama a sus métodos, la instancia. Cada uno de esos vínculos es un camino por el que un cambio puede propagarse.

A diferencia del «acoplamiento entre objetos» (CBO) o del «número de dependencias» (Dcy), que dan un número por clase, CF da un solo número para todo el proyecto y lo normaliza por el máximo posible. Esa normalización es la idea común de las métricas MOOD: el numerador es el uso real de un mecanismo y el denominador, el uso máximo que permitiría el mismo número de clases. Así se pretende poder comparar sistemas de tamaños distintos.

Desde la revisión de 1995, la herencia se deja fuera a propósito. Que una subclase use a su superclase es parte de heredar; MOOD mide la herencia con otras métricas («MIF» y «AIF») y reserva CF para el acoplamiento entre clases que no están emparentadas.

Cómo se calcula

Con TCTC clases en el sistema, Brito e Abreu define la relación cliente Cc⇒CsC_c \Rightarrow C_s: la clase cliente CcC_c contiene al menos una referencia a un método o a un atributo de la clase proveedora CsC_s. El numerador cuenta los pares ordenados de clases que cumplen esa relación; la definición cambió entre las dos publicaciones:

  • En la propuesta de 1994 (Brito e Abreu y Carapuça) cuenta cualquier par de clases distintas, también las unidas por herencia, y el denominador es el número de pares ordenados de clases distintas:
is_client(Cc,Cs)={1si Cc⇒Cs y Cc≠Cs0en otro casoCF=∑i=1TC∑j=1TCis_client(Ci,Cj)TC2−TC\text{is\_client}(C_c, C_s) = \begin{cases} 1 & \text{si } C_c \Rightarrow C_s \text{ y } C_c \neq C_s\\ 0 & \text{en otro caso} \end{cases} \qquad\qquad CF = \frac{\sum_{i=1}^{TC}\sum_{j=1}^{TC} \text{is\_client}(C_i, C_j)}{TC^2 - TC}
  • En la revisión de 1995 (Brito e Abreu, Goulão y Esteves) se deja fuera la herencia: dos clases unidas por una relación de herencia, directa o indirecta, no cuentan como cliente y proveedor, y el denominador resta esos pares (en los dos sentidos), donde DC(Ci)DC(C_i) es el número de descendientes de CiC_i:
CF=∑i=1TC∑j=1TCis_client(Ci,Cj)TC2−TC−2∑i=1TCDC(Ci)CF = \frac{\sum_{i=1}^{TC}\sum_{j=1}^{TC} \text{is\_client}(C_i, C_j)}{TC^2 - TC - 2\sum_{i=1}^{TC} DC(C_i)}

La relación se cuenta en cada sentido por separado: si A usa a B y B usa a A, son dos acoplamientos.

Para quien empieza. TC2−TCTC^2 - TC es simplemente TC×(TC−1)TC \times (TC - 1): cada clase podría depender de cada una de las otras. Con 10 clases hay 90 dependencias posibles.

Ejemplo

Cuatro clases del mismo proyecto (cada una en su fichero):

public class Customer { }                           // no usa a nadie

public class Product { }                            // no usa a nadie

public class Order {
    Customer customer;                              // Order -> Customer: 1
    Product product;                                // Order -> Product: 1
}

public class SpecialOrder extends Order {
    Order original;                                 // SpecialOrder -> Order: unidas por herencia
}

Pares ordenados posibles con TC=4TC = 4: 4×3=124 \times 3 = 12.

  • Con la definición de 1994, que no excluye la herencia, cuentan los tres vínculos: CF=3/12=25 %CF = 3 / 12 = 25\,\%.
  • Con la de 1995, el campo original no suma aunque SpecialOrder use a Order de verdad, y el denominador descuenta los 2×12 \times 1 pares de la jerarquía Order-SpecialOrder: CF=2/10=20 %CF = 2 / 10 = 20\,\%.
  • Stau Metro excluye la herencia del numerador pero no del denominador: CF=2/12≈16,7 %CF = 2 / 12 \approx 16{,}7\,\%.

Cómo interpretarla

Un CF alto significa que las clases se referencian mucho entre sí: entender, probar o reutilizar una de ellas obliga a cargar con otras. Un CF bajo significa que las clases se relacionan poco. Cero no es la meta: un sistema cuyas clases no colaboran no hace nada útil, y Brito e Abreu, Goulão y Esteves (1995) lo describen como una métrica con límite inferior además de superior.

Esos mismos autores midieron cinco bibliotecas de clases en C++ (MFC, la biblioteca de GNU, ET++, NMat y MotifApp) y propusieron como umbrales iniciales de atención el intervalo de confianza al 90 % de la media de la muestra: entre 3,9 % y 17,7 %. Un CF por encima de 17,7 % era, para ellos, motivo para avisar al diseñador. Son cifras de una muestra pequeña, en otro lenguaje y con la definición de 1995; tómalas como orientación.

Stau Metro no tiene umbral de referencia para esta métrica.

Qué hacer con un valor alto: CF no dice dónde está el problema. Busca las clases responsables con las métricas por clase: «Dcy» y «CBO» para las que usan a muchas, «Dpt» para las que muchas otras usan. Las soluciones son las habituales: introducir interfaces entre capas, mover responsabilidades a la clase que tiene los datos, romper ciclos.

Ojo. El denominador crece con el cuadrado del número de clases y el numerador, en un diseño corriente, crece más o menos en proporción a ellas. Un proyecto grande tiende a un CF bajo aunque su diseño no mejore. Compara CF a lo largo del tiempo en el mismo proyecto, no entre proyectos de tamaños muy distintos.

Para profundizar

Independencia del tamaño. La normalización por TC2−TCTC^2 - TC busca que CF no dependa del número de clases. En su muestra de 1995, Brito e Abreu, Goulão y Esteves encontraron correlaciones bajas entre CF y el número de clases, métodos, atributos y líneas (entre −0,14 y −0,28), y concluyeron que la métrica era bastante independiente del tamaño, con la advertencia de que la muestra era pequeña.

Qué es «usar». La definición formal habla de referencias a métodos o atributos del proveedor, pero los propios autores la amplían al aplicarla. En 1994 cuentan también las referencias al tipo del proveedor en un atributo, en un argumento de un método o en una variable local; en la correspondencia con C++ de 1995, las llamadas a sus funciones miembro (también a través de friend), las llamadas a sus constructores y destructores y las referencias a su tipo en un atributo o en la lista de parámetros de un método. Una herramienta que cuente cualquier mención del tipo (conversiones, instanceof, anotaciones, argumentos de tipo) da algo más que esa lista, y una que solo cuente llamadas y accesos a campos, bastante menos.

Evidencia. Brito e Abreu y Melo (1996) estudiaron ocho sistemas pequeños de gestión construidos con los mismos requisitos y relacionaron las métricas MOOD con la densidad de defectos y el esfuerzo de corrección; según el resumen que hace la documentación de Project Analyzer de ese estudio, un CF mayor se asociaba con más defectos y más retrabajo.

Relación con otras métricas

En las herramientas

Stau Metro (CouplingFactorProject, a nivel de proyecto). Excluye la herencia del numerador, como la revisión de 1995, pero conserva el denominador de 1994:

CF=pares ordenados (A,B) con A que depende de BTC×(TC−1)CF = \frac{\text{pares ordenados } (A, B) \text{ con } A \text{ que depende de } B}{TC \times (TC - 1)}
  • Son clases todas las clases Java del ámbito analizado: también las interfaces, los enumerados, los records, las anotaciones, las clases anidadas y las de test. Las clases anónimas y locales no son clases de la población; sus dependencias se atribuyen a la clase que las contiene.
  • La dependencia es la de «Número de dependencias»: cualquier referencia a la clase (tipo de un campo, parámetro o variable, new, llamada, anotación, etc.), no solo el acceso a sus métodos o atributos.
  • Solo cuenta una dependencia hacia otra clase del ámbito analizado.
  • No cuenta la dependencia de una clase hacia cualquiera de sus antepasados, directos o indirectos (superclases e interfaces). La de una superclase hacia una subclase sí cuenta, aunque la definición de 1995 la excluye.
  • Una clase anidada que usa a otra cuenta como clase propia (el test del proyecto fija que una clase externa, su clase anidada y una tercera clase, con una sola dependencia, dan 1/6).
  • Con una sola clase no hay valor (el denominador es 0).

Como el denominador no descuenta los pares unidos por herencia, en un proyecto con jerarquías el valor queda por debajo del de la definición de 1995 (las dependencias de una superclase hacia sus subclases lo compensan solo en parte) y no es directamente comparable con los umbrales de aquel artículo.

Project Analyzer (Aivosto, para Visual Basic). Documenta CF como acoplamientos reales entre acoplamientos máximos; una clase está acoplada a otra si llama a sus métodos o accede a sus variables, cada sentido cuenta por separado y se excluyen los acoplamientos de la herencia (Inherits).

MetricsReloaded (plugin de IntelliJ IDEA). En su código fuente, divide la suma de las dependencias de cada clase entre TC×(TC−1)/2TC \times (TC - 1) / 2, e incluye las dependencias hacia las superclases (un comentario del propio código lo señala como inexacto).

Referencias