Número de comprobaciones de null
| Sigla | NULL |
| Aspecto | «Complejidad» |
| Se mide en | método |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumNullChecks |
En pocas palabras
Cuenta las veces que un método compara algo con null usando == o !=. Muchas comprobaciones suelen indicar que
nadie tiene claro quién garantiza que un valor existe, y que cada método se protege por su cuenta.
Qué mide
Cuánto código defensivo contra null hay en un método. Cada comprobación es una decisión más que probar (con valor
y sin él) y, repetida en muchos métodos, es una señal de que el diseño no fija en un solo sitio qué referencias
pueden ser nulas. Se reduce con tipos que expresan la ausencia (Optional), con anotaciones de nulabilidad, con
colecciones vacías en lugar de null y con objetos nulos.
Cómo se calcula
Se suma 1 por cada operando que sea el literal null en una expresión con == o !=.
Ejemplo
boolean same(Object a, Object b) {
if (a == null || b == null) { // +2: a == null, b == null
return a == b; // 0: no hay literal null
}
return a != null; // +1
}
Total: 3. El if y el || que rodean las dos primeras comprobaciones suman en la
«complejidad ciclomática»; la del último return no suma allí, porque no decide nada.
Cómo interpretarla
No tiene umbrales. Compáralo con el «tamaño del método»: tres comprobaciones en un método de
tres líneas son mucho más que tres en uno de cincuenta. Mira especialmente los métodos que lo repiten en cascada
(a != null && a.b() != null && …), que suelen indicar un valor que debería ser obligatorio.
Relación con otras métricas
- «Complejidad ciclomática» (
v(G)): elify el&&o||que rodean una comprobación denullsuman env(G); esta métrica aísla qué parte de esa lógica es defensa frente anull. - «Número de expresiones de conversión de tipo» (
CAST): la otra comprobación en tiempo de ejecución que se cuenta por método, la del tipo de un valor. - «Número de sentencias de control» (
CONTROL): losifque contienen estas comprobaciones.
En las herramientas
Stau Metro (NumNullChecks, a nivel de método). Cuenta los operandos que son el literal null en expresiones
con == o !=; null == null suma 2. No cuenta las comparaciones entre variables que valgan null, las llamadas a
Objects.isNull, Objects.requireNonNull o Optional, ni case null en un switch, ni un null escrito entre
paréntesis (x == (null)). En o == null || i == 0 suma 1. Incluye lo que haya en lambdas y en clases anónimas o
locales declaradas en el método. No se calcula para los métodos abstractos.
CK (herramienta de Aniche). Su comparisonsQty cuenta «el número de comparaciones (es decir, == y !=)», todas,
no solo las que tienen null.
Referencias
- Aniche, M., herramienta CK, descripción de métricas: https://github.com/mauricioaniche/ck