Número de sentencias assert
| Sigla | ASSERT |
| 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 | NumAsserts |
En pocas palabras
Cuenta las sentencias assert que hay dentro de un método. Un assert es una comprobación que el programador deja
escrita para afirmar algo que cree cierto en ese punto («esta lista no está vacía»). Un valor alto indica un método
que documenta y vigila muchas de sus suposiciones.
Qué mide
El grado en que un método se apoya en la sentencia assert del lenguaje para comprobar sus precondiciones, sus
invariantes o sus resultados intermedios. No dice nada sobre la calidad del método: un método sin ningún assert no
es peor por ello.
Ojo. La especificación del lenguaje deja a la plataforma decidir si las aserciones están activas, y el lanzador
javalas desactiva por defecto: solo se ejecutan si se arranca con-ea. Además,assertno tiene nada que ver con las aserciones de los tests (assertEqualsy similares), que cuenta «el número de aserciones de test JUnit».
Cómo se calcula
Se cuenta 1 por cada sentencia assert del cuerpo del método, tenga o no mensaje. La sentencia se define en la
especificación del lenguaje (JLS, sección 14.10, The assert Statement).
Cómo interpretarla
No tiene umbrales. Úsala para localizar qué métodos y qué módulos aplican la programación por contrato con assert,
y compárala con el tamaño del método («sentencias»): cuatro assert en un método de cuarenta
líneas no significan lo mismo que cuatro en uno de seis.
Relación con otras métricas
- «Número de aserciones de test JUnit» (
JTA): las aserciones de los tests, que son llamadas a métodos y no sentencias del lenguaje; no se mezclan con esta. - «Número de sentencias» (
STAT): el tamaño del método frente al que se lee este recuento.
En las herramientas
Stau Metro (NumAsserts, a nivel de método). Cuenta las sentencias assert del cuerpo del método, incluidas las
que estén dentro de lambdas y de clases anónimas o locales declaradas en él, que se suman al método que las
contiene. No se calcula para los métodos abstractos ni para los de una interfaz que no sean default, static o
private. Los constructores cuentan como métodos. Se mide también el código de test. Las sentencias assert de un
inicializador estático o de un inicializador de campo no pertenecen a ningún método y no se cuentan.
Referencias
- The Java Language Specification, Java SE 21 Edition, sección 14.10 («The assert Statement»): https://docs.oracle.com/javase/specs/jls/se21/html/jls-14.html
- Documentación del lanzador
java(JDK 21), opción-enableassertions: https://docs.oracle.com/en/java/javase/21/docs/specs/man/java.html