Maven Surefire Plugin

Si queremos ejecutar test unitarios de nuestras aplicaciones gestionadas con Maven, podemos usar el plugin Surefire. Este plugin se usa durante la fase de test y genera informes en dos formatos: archivo de texto plano(*.txt) y archivos XML (*.xml). Por defecto dichos informes se generan en la carpeta ${basedir}/target/surefire-reports.

El plugin solo posee una meta (goal) , surefire:test, que se encarga de ejecutar los test, podemos ver todos los atributos de configuración de la meta aquí.

Para poder usar el plugin debemos configurar nuestro fichero POM para que incluya el plugin:

Por defecto, el plugin Surefire incluirá todas las clases de test que cumplan los patrones:

• "**/Test*.java" - Incluye todas las clases de su subdirectorio cuyo nombre comience por "Test".
• "**/*Test.java" - Incluye todas las clases de su subdirectorio cuyo nombre termine por "Test".
• "**/*TestCase.java" - Incluye todas las clases de su subdirectorio cuyo nombre termine por "TestCase".

Podemos definir otros patrones para las clases de test que se usarán, tan solo debemos añadirlo en la configuración usando los tags <>< /includes>. También podemos excluir los ficheros que cumplan cierto patrón usando los tags <>< /exludes>. Por ejemplo:

Asimismo podemos definir si queremos pasar de la ejecución de los test añadiendo en la configuración el tag <>true< /skiptests>, o bien si usamos un comando añadiéndole -DskipTest.

mvn install -DskipTest

Si lo que queremos es que ni siquiera se compilen los test usaremos -Dmaven.test.skip=true.

mvn install -Dmaven.test.skip

Al comenzar comentabamos que los informes que genera el plugin se generan en texto plano o XMl, pero podemos tener los informes en formato HTML,para ello debemos usar Maven Surefire ReportPlugin.

Nota: El uso del reporting lo veremos en el futuro en otro artículo.