Introduzione a JUnit

Introduzione al Testing in Java

Maria Milusheva

Senior Software Engineer

Dati rapidi

JUnit è la libreria di testing Java più diffusa
È ben mantenuta e aggiornata regolarmente

Immagine del logo JUnit 5.

Scrivere un test JUnit

Scriviamo un test per il metodo addTwoNumbers():

public int addTwoNumbers(int a, int b) {
    return a + b;
}

Annotazione JUnit @Test

Installa JUnit con un IDE o con build tool (esempio nella citazione)
Ogni test deve avere l'annotazione @Test:

import org.junit.jupiter.api.Test;

@Test 
// Qui andrà il metodo di test

Annotazione - metadato speciale che indica come il metodo deve essere gestito da compilatori e framework. Le annotazioni iniziano con @

¹ https://www.jetbrains.com/help/idea/junit.html

Struttura di un test JUnit

import org.junit.jupiter.api.Test;

@Test 

void testAddTwoNumbers() {

    // Arrange - Given
    int num1 = 2;
    int num2 = 2;


    // Act - When  
    int actual = addTwoNumbers(num1, num2);


    // Assert - Then  
    assertEquals(4, actual); 
}

Istruzioni assert

Confronto rapido tra risultati ottenuti e attesi
Se atteso e ottenuto non coincidono, il test fallisce
Aiuta a trovare bug ed errori velocemente

Grafica che rappresenta un'istruzione assert

Esiti del test

Considera l'asserzione:

assertEquals(4, actual); // Va a buon fine se actual == 4

Se passa, produce il messaggio Test passed

Se i valori non sono uguali, es. actual = 5:

org.opentest4j.AssertionFailedError: expected: <4> but was: <5>

Ricorda l'ordine degli argomenti! In JUnit il primo è quello atteso.

Test aggiuntivo per overflow

@Test 

void testAddTwoNumbers() { 
    // Given
    int num1 = 2147483647;
    int num2 = 1;  

    // When  
    int actual = addTwoNumbers(num1, num2); 

    // Then  
    assertEquals(-2147483648, actual);
}

Note su JUnit e i test

Un test può avere più asserzioni
Tutte devono passare perché il test passi
Possiamo importare tutte le asserzioni con:

import org.junit.jupiter.api.Assertions.*;

Altre note

Di seguito c'è uno strumento personalizzato Datacamp, non serve nell'IDE:

import static com.datacamp.util.testing.CustomJUnitTestLauncher.launchTestsAndPrint;

import static package.Class.method permette di usare method come method, senza scrivere package.Class.method

import static java.lang.Math.max;

...

max(3,5); // Invece di Math.max(3, 5)

Ayo berlatih!

Introduzione al Testing in Java