Número de clases raíz

Actualizado el 15 de noviembre de 2026

Sigla ROOT (ROOT(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 NumRootClassesPackage, NumRootClassesRecursivePackage, NumRootClassesModule, NumRootClassesProject

En pocas palabras

Una clase raíz es la que está arriba del todo de su cadena de herencia: no extiende a ninguna otra, salvo a Object, que en Java extienden todas. La métrica cuenta cuántas hay, que es aproximadamente cuántas jerarquías de herencia empiezan en el código.

Qué mide

Cuántos árboles de herencia empiezan en el código. Una clase que no extiende ninguna otra abre su propio árbol, aunque ese árbol sea de un solo nodo. Con ROOT bajo respecto al número de clases, muchas clases heredan de otras; con ROOT próximo al número de clases, casi no hay herencia entre clases y el diseño se apoya en composición e interfaces. Las clases que extienden una clase de biblioteca, los enumerados y los record no son raíz, así que el número de raíces no coincide con el de jerarquías cuando abundan.

No es bueno ni malo: depende del estilo. Su sentido está en la proporción con el «número de clases» y en el contraste con el «número de clases hoja».

Cómo se calcula

Se cuentan las clases, sin interfaces, que no tienen superclase o cuya única superclase es java.lang.Object.

ROOT=∣{C clase:superclase(C)=ninguna∨superclase(C)=Object}∣ROOT = |\{C \text{ clase} : \text{superclase}(C) = \text{ninguna} \lor \text{superclase}(C) = \texttt{Object}\}|

Ejemplo

abstract class Animal { }              // raíz
class Mammal extends Animal { }        // no: su superclase es Animal
class Dog extends Mammal { }           // no
class Cat extends Mammal { }           // no
class Logger { }                       // raíz
class Failure extends Exception { }    // no: su superclase no es Object
interface Walker { }                   // las interfaces no cuentan

ROOT = 2: Animal y Logger. Failure no cuenta porque su superclase es Exception, aunque Exception esté fuera del proyecto.

Cómo interpretarla

No hay umbrales.

  • ROOT alto respecto al total: pocas jerarquías de herencia entre clases; es lo normal en código que usa interfaces, composición o clases de utilidad.
  • ROOT bajo respecto al total: más clases organizadas en jerarquías, y las jerarquías serán más profundas o más anchas.
  • Cada raíz es el punto donde se decide el contrato de su jerarquía. Mira primero las raíces con muchos descendientes, porque un cambio ahí afecta a todo el árbol.

Fíjate en que una clase que extiende una clase de una biblioteca (por ejemplo, una excepción) no es raíz según esta definición: la raíz se mide respecto a Object, no respecto a las clases del proyecto.

Para profundizar

La documentación de Aivosto define ROOTS como el número de clases raíz definidas en el código fuente, o lo que es lo mismo, el número de jerarquías definidas por completo en el código fuente, y para .NET considera raíz la clase que hereda directamente de System.Object o que no declara herencia; el ideal sería una sola jerarquía, con ROOTS igual a 1. La definición de Stau Metro es la análoga para Java con java.lang.Object. Con LEAF y el número de clases, forma las razones de reutilización y de especialización descritas en «Número de clases hoja».

Relación con otras métricas

En las herramientas

Stau Metro (NumRootClassesPackage, NumRootClassesRecursivePackage, NumRootClassesModule y NumRootClassesProject). Cuenta las clases, sin interfaces ni interfaces de anotación, cuya superclase es java.lang.Object. Reglas:

  • Qué cuenta como clase. Igual que en el «número de clases»: entran las abstractas, las anidadas con nombre y las locales y anónimas; no entran los cuerpos de las constantes de un enumerado.
  • Clases anónimas. Una clase anónima que implementa una interfaz (new Runnable() { … }) tiene como superclase Object y cuenta como raíz; una que extiende una clase (new Thread() { … }), no. Las lambdas no son clases y no cuentan.
  • Superclase sin resolver. Si la clase de extends no se encuentra (falta una dependencia), el IDE toma Object como superclase y la clase cuenta como raíz.
  • Enumerados y record. Nunca son raíz: su superclase es java.lang.Enum o java.lang.Record, no Object.
  • Biblioteca. Una clase que extiende una clase ajena al proyecto, que no sea Object, no es raíz.
  • 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 (ROOT(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