Número de clases hoja

Actualizado el 15 de noviembre de 2026

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.

LEAF=∣{C clase:ninguna clase extiende directamente a C}∣LEAF = |\{C \text{ clase} : \text{ninguna clase extiende directamente a } C\}|

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 LEAF pró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 LEAF bajo respecto al total indica que muchas clases son padres de otras: más diseño por especialización.
  • Una clase hoja no final es 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 U=(CLS−LEAFS)/CLSU = (CLS - LEAFS) / CLS y la de especialización S=(CLS−ROOTS)/(CLS−LEAFS)S = (CLS - ROOTS) / (CLS - LEAFS), 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), U=0,4U = 0{,}4 y S=1,5S = 1{,}5: 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

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 los record son 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 {} y class B { Object o = new A() {}; } hay tres hojas: A, B y 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