Número de clases hoja
| Sigla | LEAF (LEAF(rec) en la variante recursiva del paquete) |
| Aspecto | «Herencia y polimorfismo» |
| Se mide en | paquete, módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumLeafClassesPackage, NumLeafClassesRecursivePackage, NumLeafClassesModule, NumLeafClassesProject |
En pocas palabras
Una clase hoja es una clase de la que nadie hereda. Esta métrica cuenta cuántas hay: cuántas clases están en el extremo de abajo de sus jerarquías. Dibujada como árbol, son las hojas.
Qué mide
Cuánto del diseño termina en clases que no se especializan más. En un diseño que usa poco la herencia, casi todas las clases son hojas (y raíces a la vez). En uno que la usa mucho, las hojas son las clases concretas del fondo y las demás son abstracciones intermedias.
Por sí sola dice poco; su valor está en la proporción respecto al «número de clases» y en el contraste con el «número de clases raíz», que cuenta el otro extremo.
Cómo se calcula
Es el número de clases del ámbito que no tienen ninguna subclase directa. Una interfaz nunca es una clase hoja.
Basta mirar los hijos directos: si una clase tiene un nieto, tiene también un hijo.
Ejemplo
abstract class Animal { } // raíz, no hoja: tiene hijos
class Mammal extends Animal { } // ni raíz ni hoja
class Dog extends Mammal { } // hoja
class Cat extends Mammal { } // hoja
class Logger { } // raíz y hoja a la vez
interface Walker { } // las interfaces no cuentan
LEAF = 3: Dog, Cat y Logger. Con 5 clases en total, las hojas son el 60 %.
Cómo interpretarla
No hay umbrales. Orientaciones:
- Un
LEAFpróximo al número de clases indica una jerarquía plana: casi todo son clases independientes o directamente hijas de otras, sin niveles intermedios. - Un
LEAFbajo respecto al total indica que muchas clases son padres de otras: más diseño por especialización. - Una clase hoja no
finales una extensión posible pero no usada; no hace falta tratarla como un problema.
Con la herencia, lo importante suele ser la forma del árbol, no solo los extremos: combínala con la «profundidad» y el «número de hijos».
Para profundizar
La documentación de Aivosto define una clase hoja como la que otras no heredan (allí CLS incluye también las
interfaces), y construye con LEAFS, ROOTS y el número de clases CLS dos razones: la de reutilización
y la de especialización , que interpreta como el promedio
de clases derivadas por clase base. Con el ejemplo de arriba, contando solo las clases (CLS = 5, LEAFS = 3 y 2
raíces: Animal y Logger), y : Animal tiene un hijo y Mammal, dos. Stau Metro no calcula esas razones, pero LEAF y ROOT son sus ingredientes.
Relación con otras métricas
- «Número de clases raíz» (
ROOT): el otro extremo de las jerarquías. - «Número de clases» (
C): el total sobre el que se mide la proporción. - «Número de hijos» (
NOC): una clase es hoja exactamente cuando suNOCes 0. - «Número de subclases» (
SUB): el equivalente que cuenta todos los descendientes. - «Profundidad del árbol de herencia» (
DIT): la altura de cada hoja.
En las herramientas
Stau Metro (NumLeafClassesPackage, NumLeafClassesRecursivePackage, NumLeafClassesModule y
NumLeafClassesProject). Cuenta las clases, sin las interfaces, que ninguna clase con nombre del ámbito analizado
extiende directamente. Reglas:
- Qué cuenta como clase. Entran las clases abstractas, los enumerados, los
record, las clases anidadas con nombre y también las anónimas y las locales, igual que en el «número de clases». No entran las interfaces ni las interfaces de anotación, ni los cuerpos de las constantes de un enumerado. Las clases anónimas, los enumerados (también los que tienen cuerpos en sus constantes) y losrecordson siempre hoja, porque ninguna clase con nombre puede extenderlos. - Qué cuenta como subclase. Solo las clases con nombre. Una subclase anónima o local no impide que su padre sea
hoja (en el ejemplo
class A {}yclass B { Object o = new A() {}; }hay tres hojas:A,By la clase anónima). Tampoco una subclase situada fuera del ámbito analizado, aunque exista en el proyecto, ni las clases Kotlin. - Ámbito. Por eso el valor depende de lo que se analice: una clase puede ser hoja en un módulo y no serlo en el proyecto completo.
- Niveles. Cada clase se asigna al paquete de su fichero (una anidada, al de su clase exterior), al módulo y al
proyecto. La variante recursiva del paquete (
LEAF(rec)) suma también las de los subpaquetes. El paquete por defecto solo recibe sus propias clases. - Código de test. Se cuenta igual que el de producción.
Solo cubre Java: las clases Kotlin no se cuentan.
Referencias
- Aivosto, «Miscellaneous object-oriented metrics» (documentación): https://www.aivosto.com/project/help/pm-oo-misc.html