JUnit - Test parametrizzato

JUnit 4 ha introdotto una nuova funzionalità chiamata parameterized tests. I test parametrizzati consentono a uno sviluppatore di eseguire lo stesso test più e più volte utilizzando valori diversi. Ci sono cinque passaggi da seguire per creare un test parametrizzato.

  • Annota la classe di test con @RunWith (Parameterized.class).

  • Crea un metodo statico pubblico annotato con @Parameters che restituisca una raccolta di oggetti (come array) come set di dati di test.

  • Creare un costruttore pubblico che accetti ciò che è equivalente a una "riga" di dati di test.

  • Crea una variabile di istanza per ogni "colonna" di dati di test.

  • Crea i tuoi casi di test utilizzando le variabili di istanza come origine dei dati di test.

Il test case verrà richiamato una volta per ogni riga di dati. Vediamo i test parametrizzati in azione.

Crea una classe

Crea una classe java da testare, ad esempio, PrimeNumberChecker.java in C: \> JUNIT_WORKSPACE.

public class PrimeNumberChecker {
   public Boolean validate(final Integer primeNumber) {
      for (int i = 2; i < (primeNumber / 2); i++) {
         if (primeNumber % i == 0) {
            return false;
         }
      }
      return true;
   }
}

Crea classe test case parametrizzata

Crea una classe di prova java, diciamo, PrimeNumberCheckerTest.java. Crea un file di classe java denominatoPrimeNumberCheckerTest.java in C: \> JUNIT_WORKSPACE.

import java.util.Arrays;
import java.util.Collection;
 
import org.junit.Test;
import org.junit.Before;

import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;
import org.junit.runner.RunWith;
import static org.junit.Assert.assertEquals;

@RunWith(Parameterized.class)
public class PrimeNumberCheckerTest {
   private Integer inputNumber;
   private Boolean expectedResult;
   private PrimeNumberChecker primeNumberChecker;

   @Before
   public void initialize() {
      primeNumberChecker = new PrimeNumberChecker();
   }

   // Each parameter should be placed as an argument here
   // Every time runner triggers, it will pass the arguments
   // from parameters we defined in primeNumbers() method
	
   public PrimeNumberCheckerTest(Integer inputNumber, Boolean expectedResult) {
      this.inputNumber = inputNumber;
      this.expectedResult = expectedResult;
   }

   @Parameterized.Parameters
   public static Collection primeNumbers() {
      return Arrays.asList(new Object[][] {
         { 2, true },
         { 6, false },
         { 19, true },
         { 22, false },
         { 23, true }
      });
   }

   // This test will run 4 times since we have 5 parameters defined
   @Test
   public void testPrimeNumberChecker() {
      System.out.println("Parameterized Number is : " + inputNumber);
      assertEquals(expectedResult, 
      primeNumberChecker.validate(inputNumber));
   }
}

Crea classe Test Runner

Crea un file di classe java denominato TestRunner.java in C: \> JUNIT_WORKSPACE per eseguire i casi di test.

import org.junit.runner.JUnitCore;
import org.junit.runner.Result;
import org.junit.runner.notification.Failure;

public class TestRunner {
   public static void main(String[] args) {
      Result result = JUnitCore.runClasses(PrimeNumberCheckerTest.class);

      for (Failure failure : result.getFailures()) {
         System.out.println(failure.toString());
      }
		
      System.out.println(result.wasSuccessful());
   }
}

Compilare le classi PrimeNumberChecker, PrimeNumberCheckerTest e Test Runner utilizzando javac.

C:\JUNIT_WORKSPACE>javac PrimeNumberChecker.java PrimeNumberCheckerTest.java
TestRunner.java

Ora esegui Test Runner, che eseguirà i casi di test definiti nella classe Test Case fornita.

C:\JUNIT_WORKSPACE>java TestRunner

Verifica l'output.

Parameterized Number is : 2
Parameterized Number is : 6
Parameterized Number is : 19
Parameterized Number is : 22
Parameterized Number is : 23
true