Apache Maven
Maven Surefire Plugin

Sintassi

• prova mvn
• mvn -Dtest = com.example.package.ExampleTest test

Test di una classe Java con JUnit e il plugin Maven Surefire

Il plug-in Maven Surefire viene eseguito durante la fase di test del processo di generazione di Maven o quando il test viene specificato come obiettivo Maven. La seguente struttura di directory e il file pom.xml minimo configureranno Maven per eseguire un test.

Struttura della directory all'interno della directory principale del progetto:

─ project_root 
  ├─ pom.xml
  ├─ src
  │  ├─ main
  │  │  └─ java
  │  └─ test
  │     └─ java
  └─ target
     └─ ...

pom.xml contenuto:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>company-app</artifactId>
  <version>0.0.1</version>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

Creare un file denominato PlusTenTest.java con i seguenti contenuti nella directory src/test/java/com/example/app :

package com.example.app;

import static org.junit.Assert.assertEquals;
import org.junit.Test;

public class PlusTenTest {
    
    @Test
    public void incrementTest() {
        int result = PlusTen.increment(10);
        assertEquals("PlusTen.increment(10) result", 20, result);
    }
}

L'annotazione @Test indica a JUnit che dovrebbe eseguire incrementTest() come test durante la fase di test del processo di generazione di Maven. Ora crea PlusTen.java in src/main/java/com/example/app :

package com.example.app;

public class PlusTen {
    public static int increment(int value) {
        return value;
    }
}

Esegui il test aprendo un prompt dei comandi, navigando alla directory principale del progetto e richiamando il seguente comando:

mvn -Dtest=com.example.app.PlusTenTest test

Maven compilerà il programma ed eseguirà il metodo di prova incrementTest() in PlusTenTest . Il test fallirà con il seguente errore:

...
Tests run: 1, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.005 sec <<< FAILURE! - in com.example.app.PlusTenTest
incrementTest(com.example.app.PlusTenTest)  Time elapsed: 0.004 sec  <<< FAILURE!
java.lang.AssertionError: PlusTen.increment(10) result expected:<20> but was:<10>
at org.junit.Assert.fail(Assert.java:88)
at org.junit.Assert.failNotEquals(Assert.java:743)
at org.junit.Assert.assertEquals(Assert.java:118)
at org.junit.Assert.assertEquals(Assert.java:555)
at com.example.app.PlusTenTest.incrementTest(PlusTenTest.java:12)


Results :

Failed tests:   
  PlusTenTest.incrementTest:12 PlusTen.increment(10) result expected:<20> but was:<10>

Tests run: 1, Failures: 1, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.749 s
[INFO] Finished at: 2016-09-02T20:50:42-05:00
[INFO] Final Memory: 14M/209M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project app: There are test failures.
...

Il plugin Maven Surefire crea una directory /target/surefire-reports/ nella directory del progetto contenente i file com.example.app.PlusTenTest.txt e TEST-com.example.app.PlusTenTest.xml che contengono i dettagli dell'errore dell'inizio dell'output sopra.

Seguendo il modello di sviluppo basato su test, modificare PlusTen.java modo che il metodo increments() PlusTen.java correttamente:

package com.example.app;

public class PlusTen {
    public static int increment(int value) {
        return value + 10;
    }
}

Richiama nuovamente il comando:

mvn -Dtest=com.example.app.PlusTenTest test

Il test passa:

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.example.app.PlusTenTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.028 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.753 s
[INFO] Finished at: 2016-09-02T20:55:42-05:00
[INFO] Final Memory: 17M/322M
[INFO] ------------------------------------------------------------------------

Congratulazioni! Hai testato una classe Java usando JUnit e il plugin Maven Surefire.