JUnit Förväntat undantagstest: @Test(förväntat)

JUnit ger möjlighet att trace undantaget och även för att kontrollera om koden utlöser det förväntade undantaget eller inte.

JUnit 4 erbjuder ett enkelt och lättläst sätt att testa undantag. Du kan använda:

• Den valfria parametern (förväntad) för @Test-annoteringoch
• Till tracinformationen kan ”fail()” användas.

Medan testning ett undantag måste du se till att undantagsklassen du anger i den valfria parametern för @Test-annotering är samma som metoden faktiskt kastar. Detta beror på att du förväntar dig ett undantag från metoden du enhetstestning; annars vår JUnit testet skulle misslyckas.

Exempel: @Test(förväntat = IllegalArgumentException.class)

Genom att använda parametern ”expected” kan du ange undantagsnamnet som vårt test kan utlösa. I exemplet ovan använder du ”Ogiltigt argumentundantag", vilket kommer att utlösas av testet om en utvecklare använder ett argument som inte är tillåtet.

Exempel med @Test(förväntat)

Låt oss förstå undantagstestning genom att skapa en Java klass med en metod som kastar en undantagDu kommer att hantera det och testa det i en testklass. Överväg JUnitMessage.java, som har en metod som utför en matematisk operation. Divisionen på rad 14 dividerar med noll, så metoden utlöser alltid ett "ArithmeticException". Se nedan:

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 Förklaring:

• Code Linje 7: Skapa en parametriserad konstruktor med fältinitiering.
• Code Rad 11-14: Skapa en metod för den matematiska operationen.
• Code Linje 18: Skapar en annan metod för att skriva ut ett meddelande.
• Code Linje 20: Skapa en ny sträng för att skriva ut ett meddelande.
• Code Linje 22: Skriver ut det nya meddelandet som skapades på rad 20.

Låt oss skapa en testklass för ovanstående Java klass för att verifiera undantaget.

Se nedan testklassen som enhetstestar undantaget (här ArithmeticException) som genereras från ovanstående. Java klass:

AirthematicTest.java

Skärmdumpen nedan visar samma test i editorn, där filen sparas som AirthematicTest1, med den förväntade parametern markerad på rad 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 Förklaring:

• Code Linje 13: Använder @Test-annoteringen för att skapa vårt test. När du kör metoden i klassen ovan kommer den att anropa en matematisk operation. Här förväntas ArithmeticException, så du listar den som en parameter i @Test.
• Code Linje 17: Anropar printMessage() från JUnitMessage.java.
• Code Rad 21-22: Skapar ytterligare en testmetod för att kontrollera Hi-meddelandet, den här gången utan en förväntad parameter.

Klassen innehåller två testmetoder, så en enda körning kör båda: den som förväntar sig ArithmeticException och den som assertar på den returnerade strängen.

Obs: Detta exempel används under tre namn i originalmaterialet — listan anropar klassen AirthematicTest, redigerarens skärmdump visar AirthematicTest1 och resultatvyn rapporterar JunitTestExample. Koden är identisk i varje; endast filnamnet skiljer sig åt.

Låt oss utföra det och verifiera resultatet. JUnit se nedan rapporterar förloppet av JunitTestExample.java.

Produktion:

Här är utdata, som visar ett lyckat test utan fel trace enligt nedan:

Båda metoderna är gröna. Den första går igenom eftersom det deklarerade ArithmeticException faktiskt anlände, och den andra går igenom eftersom den returnerade strängen matchade. Om divisionen aldrig hade kastats, JUnit skulle ha misslyckats med den första metoden med meddelandet "Förväntat undantag: java.lang.ArithmeticException".

Tre sätt att testa ett undantag i JUnit 4

Den förväntade parametern är den kortaste av de tre JUnit 4 idiom, men det är inte alltid det rätta. Tabellen jämför dem utifrån de två frågor som avgör valet: kan du hävda dig på budskapet, och vet du vilken rad som kastades?

Idiomet fail() som nämns i inledningen ser ut så här. Om anropet inte utlöser något, körs fail() och testet rapporterar meddelandet du skrev:

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

Regeln ExpectedException ligger mellan de två. Den föråldrades i JUnit 4.13 till förmån för assertThrows-metoden som beskrivs härnäst, så ny JUnit 4 tester bör inte använda det.

Hur man testar undantag i JUnit 5 med assertThrows()

JUnit 5 tar bort den förväntade parametern helt och hållet från @Test. Jupiter tillhandahåller assertThrows(), som tar undantagsklassen och en lambda som innehåller koden under test. Den returnerar undantaget den fångade, så att meddelandet, orsaken och eventuella anpassade fält kan bekräftas efteråt.

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 relaterade påståenden komplettera familjen:

• hävdaKast accepterar undantagstypen eller någon underklass av den.
• hävdaKastaExakt förkastar en underklass, så endast den namngivna typen godkänns.
• hävdarKastaInte anger den motsatta förväntan, att blocket slutförs rent.

Ocuco-landskapet JUnit 4-koden på den här sidan körs fortfarande på JUnit Plattform genom den gamla motorn, så inget ovanför behöver skrivas om för att fortsätta fungera medan ett projekt migreras.

Vanliga misstag vid testning av undantag i JUnit

Undantagstester misslyckas på ett litet antal igenkännbara sätt. Varje rad anger symptom, orsak och lösning.

Den sista raden är den som fångar de flesta mitt under migreringen, eftersom båda annoteringarna heter @Test och det är bara importen som skiljer dem åt.ping ett JUnit version per testfall klassen undviker hela klassproblemet.

Vanliga frågor