JUnit Test 4 Übersicht mit Beispiel

JUnit ist eines der wichtigsten Tools, die man als Java-Entwickler beherrschen sollte. Es erleichtert das Testen von Java-Klassen und ist zu 100% in Eclipse integriert! Anhand einer Beispiel-Klasse erkläre ich den Aufbau und die Funktionsweise von JUnit Test 4. Warum man eigentlich JUnit nutzen sollte, erläutert Jörg Hinrichs in seinem Artikel „Unit Tests: Zeitverschwendung?“.

Die zutestende Klasse

Extrem schwer und darum kaum verwendete, teste ich heute die legendäre Rechteck-Klasse.

public class Rechteck {

	private int a;
	private int b;

	public Rechteck(int a, int b) {
		this.a = a;
		this.b = b;
	}

	public float berechneUmfang() {
		return 2 * b + 2 * a;
	}

	public float berechneInhalt() {
		return a * b;
	}
}

Ordnerstruktur

Allgemein empfehle ich einen neuen Source-Ordner namens „test“ anzulegen und die ggf. vorhandene Paketstruktur zu übernehmen. Dies erhöht die Übersichtlichkeit und erleichtert die Testkoordination. In der folgenden Abbildung sieht man die neue Projekt-Struktur:

Einen Testfall erstellen

Um die Rechteck-Klasse zu testen, lege ich eine neue Klasse im Test-Source-Ordner an. Diese Klasse erhält den Zusatz „Test“, um sie von der ursprünglichen Klasse unterscheiden zu können. Die neue „RechteckTest“-Klasse wird nun um eine einfache Public-Methode „derTest1“ erweitert.
Um diese Methode als Testfall zu deklarieren, wird die Annotation „@Test“ über die Klasse geschrieben. Dies führt jedoch zu einem Compilerfehler. Um den Compilerfehler zu beheben, muss man die Bibliothek von JUnit 4 dem Projekt hinzufügen. (Links auf die Lampe klicken)

Innerhalb der neuen Methode „derTest1“ wird nun ein Testfall definiert. Die Prüfung, ob der Testfall positiv oder negativ ausgefallen ist, wird mittels der Assert-Klasse durchgeführt. Diese Klasse stellt verschiedene Methoden zur Verfügung um Objekte, Werte und Bedingungen zu prüfen. Im folgenden Beispiel teste ich die Berechnung des Umfangs eines Rechtecks. Hierzu lege ich mir ein Rechteck-Objekt an und lasse mir den Umfang berechnen. Vorab habe ich mir mithilfe der Testdaten (Länge: 10cm und Breite: 20cm) einen Wert von 60 cm ausgerechnet.

import org.junit.Assert;
import org.junit.Test;

public class RechteckTest {
	
	@Test
	public void derTest1() {
		Rechteck myRechteck = new Rechteck(10, 20);
		Assert.assertTrue(60 == myRechteck.berechneUmfang());		
	}
}

Assert-Methoden

Natürlich kann man auch andere Methoden der Assert-Klasse verwenden. Diese sind in der folgenden Tabelle aufgelistet:

Testlauf

Um einen Testlauf mit unserer Test-Klasse zu startet, brauchen wir nur eine lauffähige Eclipse Version. Hierzu selektiert man mit einem Rechtsklick die Test-Klasse und wählt im Kontextmenü unter dem Punkt „Run As“ den Eintrag „JUnit Test“ aus. Automatisch öffnet Eclipse die JUnit-Ansicht und zeigt das/die Ergebnisse des Testlaufs an.

Testvorbereitung und Testabbau

Oftmals will man nicht ständig neue Objekte erschaffen, sondern sie über mehrere Testfälle hinweg weiter „bearbeiten“. Aus diesem Grund gibt es weitere Annotationen, die wir verwenden können. Die folgende Tabelle fast diese zusammen:

Die vollständige Test-Klasse

Wendet man die oben beschriebenen Annotationen an, ergibt sich folgende komplexe Test-Klasse:

import org.junit.After;
import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Test;

public class RechteckTest {
	
	private static Rechteck myRechteck;
	
	@BeforeClass
	public static void create() {
		// Test-Objekt erschaffen mit den Testwerten (Länge: 10 und Breite: 20)
		myRechteck = new Rechteck(10, 20);
		System.out.println("Start!");
	}
	
	@Before
	public void vor() {
		// Diese Methode wird vor jedem Testfall ausgeführt
		System.out.println("vor Test");
	}
	
	@Test
	public void derTest1() {
		// Testfall 1: Prüfung ob Umfangsberechnung stimmt
		System.out.println("Test1");
		Assert.assertTrue(60 == myRechteck.berechneUmfang());		
	}
	
	@Test
	public void derTest2() {
		// Testfall 2: Prüfung ob Flächeninhaltsberechnung stimmt
		System.out.println("Test2");
		Assert.assertNotNull(myRechteck.berechneInhalt());	
	}
	
	@After
	public void nach() {
		// Diese Methode wird nach jedem Testfall ausgeführt z.B. um einen bestimmten Zustand zu erreichen
		System.out.println("nach Test");
	}
	
	@AfterClass
	public static void delete() {
		// Diese Methode wird am Ende der Test-Klasse ausgeführt z.B. zum aufräumen oder löschen von Rückständen
		System.out.println("Test Ende!");
	}
}

Ausgabe

Start!
vor Test
Test1
nach Test
vor Test
Test2
nach Test
Test Ende!

Beispiel

[download id=“6″ format=“2″]

Copyright © 2011 AxxG – Alexander Gräsel