Orden de nivel ajustado
| Sigla | Level* |
| Aspecto | «Acoplamiento» |
| Se mide en | clase, interfaz, paquete |
| Tipo de valor | entero, mínimo 1 |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | AdjustedLevelOrderClass, AdjustedLevelOrderInterface, AdjustedLevelOrderPackage |
En pocas palabras
Es el «orden de nivel» con una corrección: un ciclo de dependencias no cuenta como un solo piso, sino como tantos pisos como elementos lo forman. Así, un ciclo de diez clases no se esconde detrás de un nivel modesto.
Qué mide
La profundidad de un elemento en el grafo de dependencias, penalizando los ciclos por su tamaño. El orden de nivel trata un ciclo como un único nodo, lo que tiene sentido para ordenar, pero oculta cuánto código está enredado: un ciclo de dos paquetes y uno de veinte suben el nivel lo mismo, uno. El orden de nivel ajustado los distingue.
Una forma de leerlo: los miembros de un ciclo no se pueden probar por separado, así que, a efectos de un orden de pruebas de abajo arriba, se comportan como una pila de tantos elementos como tiene el ciclo.
Cómo se calcula
Se calculan las componentes fuertemente conexas del grafo (los ciclos; ver «orden de nivel»). Para una componente con miembros:
Todos los miembros de la componente reciben ese valor. Para un elemento que no está en ningún ciclo, y la
fórmula es la del orden de nivel; si el grafo no tiene ciclos, Level* y Level coinciden en todos los elementos.
Ejemplo
Ciclo a → b → c → a, del que solo c sale hacia d, y un paquete top que depende de a:
| Elemento | Componente | Level |
Level* |
|---|---|---|---|
d |
{d} |
1 | 1 |
a, b, c |
{a, b, c} |
1 + 1 = 2 | 3 + 1 = 4 |
top |
{top} |
1 + 2 = 3 | 1 + 4 = 5 |
La diferencia entre las dos columnas, 2 en a, b, c y top, es exactamente lo que añade el ciclo: tres
miembros en lugar de uno.
Cómo interpretarla
No tiene umbral. Se lee junto al orden de nivel:
Level*igual aLevel: el elemento no está en ningún ciclo, y los ciclos que pueda haber debajo no alargan su cadena más larga. Si no hay ningún ciclo debajo, siempre son iguales.Level*mayor queLevel: hay al menos un ciclo en el elemento o por debajo de él. Si el propio elemento está en un ciclo, siempre es mayor. La diferencia da una idea de cuántos elementos enredados hay en el camino más profundo.- Un salto brusco de
Level*entre un elemento y los que dependen de él señala dónde está el ciclo que conviene romper.
El mínimo es 1: un elemento que no está en ningún ciclo y no depende de nada del proyecto. Un elemento de un ciclo de miembros que no depende de nada fuera del ciclo vale .
Ojo. La diferencia
Level* - Levelno es el número de elementos en ciclos debajo de ti: se calcula sobre el camino que da el máximo, y caminos distintos pueden dar el máximo de cada métrica.
Relación con otras métricas
- «Orden de nivel» (
Level): la métrica de la que se deriva; el ciclo cuenta como un nivel. - «Número de dependencias cíclicas» (
Cyclic): el tamaño del ciclo del propio elemento menos uno; es lo queLevel*suma de más en el elemento mismo. - «Número de dependencias transitivas» (
Dcy*) y «de paquete» (PDcy*): cuentan todo lo que hay debajo, no solo el camino más profundo.
En las herramientas
Stau Metro (AdjustedLevelOrderClass, AdjustedLevelOrderInterface, AdjustedLevelOrderPackage). Usa los
mismos grafos y reglas que el «orden de nivel»: clases e interfaces en un mismo grafo, con cada clase
anidada como parte de su clase de primer nivel (las dependencias entre ellas no forman ciclo); paquetes sin las
dependencias que salen de clases de test o llegan a ellas; librerías fuera del grafo; solo se recorre el código Java
del ámbito. Las interfaces de anotación no tienen valor propio. Un elemento de un ciclo de miembros sin
dependencias fuera del ciclo vale , no 1.
MetricsReloaded (plugin de IntelliJ IDEA; Adjusted level order, sigla Level*, para clases, interfaces y
paquetes). Suma también el tamaño del ciclo al máximo de lo que hay debajo. Según su código fuente, ese máximo se
toma sobre las dependencias del primer miembro del ciclo por el que se pregunta, y el resultado se copia a los
demás; Stau Metro lo toma sobre las dependencias de todos los miembros.
Referencias
- MetricsReloaded, código fuente: https://github.com/BasLeijdekkers/MetricsReloaded