Número de clases raíz
| 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.
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.
ROOTalto 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.ROOTbajo 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
- «Número de clases hoja» (
LEAF): el otro extremo; una clase sin hijos y sin padre es a la vez raíz y hoja. - «Número de clases» (
C): el total. - «Profundidad del árbol de herencia» (
DIT): una raíz tiene profundidad mínima. - «Número de hijos» (
NOC) y «subclases» (SUB): cuánto cuelga de cada raíz.
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 superclaseObjecty 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
extendsno se encuentra (falta una dependencia), el IDE tomaObjectcomo superclase y la clase cuenta como raíz. - Enumerados y
record. Nunca son raíz: su superclase esjava.lang.Enumojava.lang.Record, noObject. - 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
- Aivosto, «Miscellaneous object-oriented metrics» (documentación): https://www.aivosto.com/project/help/pm-oo-misc.html