JUnit Test dell'eccezione prevista: @Test(previsto)

JUnit fornisce la possibilità di trace l'eccezione e anche per verificare se il codice sta generando l'eccezione prevista o meno.

JUnit 4 offre un modo semplice e leggibile per testare le eccezioni. Puoi usare:

• Il parametro opzionale (previsto) del Annotazione @Teste
• A trace le informazioni, è possibile utilizzare “fail()”.

Mentre analisi un'eccezione, devi assicurarti che la classe di eccezione che stai fornendo in quel parametro opzionale del Annotazione @Test è la stessa che il metodo effettivamente lancia. Questo perché ti aspetti un'eccezione dal metodo che stai unit test; altrimenti il ​​nostro JUnit il test fallirebbe.

Esempio: @Test(expected = IllegalArgumentException.class)

Utilizzando il parametro “expected”, è possibile specificare il nome dell’eccezione che il nostro test potrebbe generare. Nell’esempio precedente, si utilizza “IllegalArgumentException", che verrà generata dal test se uno sviluppatore utilizza un argomento non consentito.

Esempio di utilizzo di @Test(expected)

Comprendiamo il test delle eccezioni creando un Java classe con un metodo che lancia un eccezioneLo gestirai e lo testerai in una classe di test. Considera JUnitIl file Message.java contiene un metodo che esegue un'operazione matematica. La divisione alla riga 14 divide per zero, quindi il metodo genera sempre un'eccezione "ArithmeticException". Vedi sotto:

package guru99.junit;

public class JUnitMessage{

	private String message;

	public JUnitMessage(String message) {
		this.message = message;
	}

public void printMessage(){

	System.out.println(message); 
	int divide=1/0;

}

public String printHiMessage(){ 

	message="Hi!" + message;
	
	System.out.println(message);

	return message;
}

}

Code Spiegazione:

• Code Linea 7: Creazione di un costruttore parametrizzato con inizializzazione del campo.
• Code Linea 11-14: Creazione di un metodo per l'operazione matematica.
• Code Linea 18: Creazione di un altro metodo per stampare un messaggio.
• Code Linea 20: Creazione di una nuova stringa per stampare un messaggio.
• Code Linea 22: Stampa del nuovo messaggio creato alla riga 20.

Creiamo una classe di test per quanto sopra Java classe per verificare l'eccezione.

Di seguito è riportata la classe di test che esegue il test unitario dell'eccezione (ArithmeticException in questo caso) generata da quanto sopra. Java classe:

AirthematicTest.java

Lo screenshot qui sotto mostra lo stesso test nell'editor, dove il file è salvato come AirthematicTest1, con il parametro previsto evidenziato alla riga 13:

package guru99.junit;

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class AirthematicTest {

	public String message = "Saurabh";
	
	JUnitMessage junitMessage = new JUnitMessage(message);
	
	@Test(expected = ArithmeticException.class)
	public void testJUnitMessage(){

		System.out.println("Junit Message is printing ");
		junitMessage.printMessage();

	}

	@Test
	public void testJUnitHiMessage(){ 
		message="Hi!" + message;
		System.out.println("Junit Message is printing ");
		assertEquals(message, junitMessage.printHiMessage());
	
	}
}

Code Spiegazione:

• Code Linea 13: Utilizziamo l'annotazione @Test per creare il nostro test. Quando si esegue il metodo della classe sopra menzionata, verrà richiamata un'operazione matematica. In questo caso è prevista un'eccezione ArithmeticException, quindi la si specifica come parametro in @Test.
• Code Linea 17: Richiamando printMessage() da JUnitMessaggio.java.
• Code Linea 21-22: Creazione di un altro metodo di test per verificare il messaggio "Ciao", questa volta senza un parametro previsto.

La classe contiene due metodi di test, quindi una singola esecuzione li esegue entrambi: quello che si aspetta un'eccezione ArithmeticException e quello che verifica la stringa restituita.

Nota: Questo esempio compare con tre nomi diversi nel materiale originale: il listato chiama la classe AirthematicTest, lo screenshot dell'editor mostra AirthematicTest1 e la visualizzazione dei risultati riporta JunitTestExample. Il codice è identico in tutti i casi; cambia solo il nome del file.

Eseguiamolo e verifichiamo il risultato. Il JUnit la vista sottostante riporta l'esecuzione di Esempio di test Junit.java.

Produzione:

Ecco l'output, che mostra un test riuscito senza errori. trace come indicato di seguito:

Entrambi i metodi sono verdi. Il primo passa perché l'ArithmeticException dichiarata è effettivamente arrivata, e il secondo passa perché la stringa restituita corrispondeva. Se la divisione non avesse mai generato, JUnit Il primo metodo avrebbe fallito con il messaggio "Eccezione prevista: java.lang.ArithmeticException".

Tre modi per testare un'eccezione in JUnit 4

Il parametro atteso è il più breve dei tre JUnit 4 espressioni idiomatiche, ma non sempre è quella giusta. La tabella le confronta in base a due domande che ne determinano la scelta: puoi affermare il messaggio e sai quale frase è stata pronunciata?

L'idioma fail() menzionato nell'introduzione si presenta in questo modo. Se la chiamata non genera un'eccezione, viene eseguito fail() e il test riporta il messaggio che hai scritto:

@Test
public void testDivideByZero() {
    try {
        junitMessage.printMessage();
        fail("Expected an ArithmeticException");
    } catch (ArithmeticException e) {
        assertEquals("/ by zero", e.getMessage());
    }
}

La regola ExpectedException si trova tra le due. È stata deprecata in JUnit 4.13 a favore del metodo assertThrows descritto di seguito, quindi nuovo JUnit 4 test non dovrebbero adottarlo.

Come testare le eccezioni in JUnit 5 con assertThrows()

JUnit 5 rimuove completamente il parametro previsto da @Test. Jupiter fornisce assertThrows(), che accetta la classe dell'eccezione e una lambda contenente il codice da testare. Restituisce l'eccezione intercettata, in modo che il messaggio, la causa e qualsiasi campo personalizzato possano essere verificati in seguito.

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import org.junit.jupiter.api.Test;

public class AirthematicJupiterTest {

    JUnitMessage junitMessage = new JUnitMessage("Saurabh");

    @Test
    public void testJUnitMessage() {
        ArithmeticException thrown = assertThrows(
                ArithmeticException.class,
                () -> junitMessage.printMessage());
        assertEquals("/ by zero", thrown.getMessage());
    }
}

Tre correlati asserzioni completa la famiglia:

• assertThrows accetta il tipo di eccezione o qualsiasi sua sottoclasse.
• assertThrowsExactly rifiuta una sottoclasse, quindi passa solo il tipo denominato.
• assertDoesNotThrow afferma l'aspettativa opposta, ovvero che il blocco venga completato senza intoppi.

Migliori JUnit 4 Il codice su questa pagina è ancora in esecuzione JUnit La piattaforma utilizza il motore vintage, quindi nulla di quanto sopra deve essere riscritto per continuare a funzionare durante la migrazione di un progetto.

Errori comuni durante il test delle eccezioni in JUnit

I test di eccezione falliscono in un numero limitato di modi riconoscibili. Ogni riga indica il sintomo, la causa e la soluzione.

L'ultima riga è quella che mette in difficoltà la maggior parte delle persone durante la migrazione, perché entrambe le annotazioni si chiamano @Test e solo l'importazione le distingue. Keeping prima JUnit versione per caso di prova la classe evita l'intera classe di problemi.

DOMANDE FREQUENTI