JUnit - Test der erwarteten Ausnahmen

JUnit - Erwarteter Ausnahmetest

In JUnit gibt es drei Möglichkeiten, die erwarteten Ausnahmen zu testen:

  1. @Test, optionales Attribut "erwartet"

  2. Try-Catch und immerfail()

  3. @Rule ExpectedException

P.S Tested with JUnit 4.12

1. @ Test erwartetes Attribut

Verwenden Sie diese Option, wenn Sie nur den Ausnahmetyp testen möchten (siehe unten):

Exception1Test.java

package com.example;

import org.junit.Test;
import java.util.ArrayList;

public class Exception1Test {

    @Test(expected = ArithmeticException.class)
    public void testDivisionWithException() {
        int i = 1 / 0;
    }

    @Test(expected = IndexOutOfBoundsException.class)
    public void testEmptyList() {
        new ArrayList<>().get(0);
    }

}

2. Try-catch und immer scheitern ()

Dies ist eine etwas alte Schule, die in JUnit 3 weit verbreitet ist. Testen Sie den Ausnahmetyp und auch das Ausnahmedetail. Siehe unten:

Exception2Test.java

package com.example;

import org.junit.Test;
import java.util.ArrayList;
import static junit.framework.TestCase.fail;
import static org.hamcrest.CoreMatchers.is;
import static org.hamcrest.MatcherAssert.assertThat;

public class Exception2Test {

    @Test
    public void testDivisionWithException() {
        try {
            int i = 1 / 0;
            fail(); //remember this line, else 'may' false positive
        } catch (ArithmeticException e) {
            assertThat(e.getMessage(), is("/ by zero"));
            //assert others
        }
    }

    @Test
    public void testEmptyList() {
        try {
            new ArrayList<>().get(0);
            fail();
        } catch (IndexOutOfBoundsException e) {
            assertThat(e.getMessage(), is("Index: 0, Size: 0"));
        }
    }


}

Always remember the fail()!
Wenn die zu testende Zeile keine Ausnahme ausgelöst hat und Sie vergessen haben,fail() einzugeben, wird der Test bestanden (falsch positiv).

3. @Rule ExpectedException

Mit dieserExpectedException-Regel (seit JUnit 4.7) können Sie sowohl den Ausnahmetyp als auch das Ausnahmedetail testen, genau wie bei der Methode „2. Try-catch and always fail()“, jedoch auf elegantere Weise:

Exception3Test.java

package com.example;

import com.example.examples.CustomerService;
import com.example.examples.exception.NameNotFoundException;
import org.junit.Rule;
import org.junit.Test;
import org.junit.rules.ExpectedException;

import static org.hamcrest.CoreMatchers.containsString;
import static org.hamcrest.CoreMatchers.is;
import static org.hamcrest.Matchers.hasProperty;

public class Exception3Test {

    @Rule
    public ExpectedException thrown = ExpectedException.none();

    @Test
    public void testDivisionWithException() {

        thrown.expect(ArithmeticException.class);
        thrown.expectMessage(containsString("/ by zero"));

        int i = 1 / 0;

    }

    @Test
    public void testNameNotFoundException() throws NameNotFoundException {

        //test type
        thrown.expect(NameNotFoundException.class);

        //test message
        thrown.expectMessage(is("Name is empty!"));

        //test detail
        thrown.expect(hasProperty("errCode"));  //make sure getters n setters are defined.
        thrown.expect(hasProperty("errCode", is(666)));

        CustomerService cust = new CustomerService();
        cust.findByName("");

    }

}

NameNotFoundException.java

package com.example.examples.exception;

public class NameNotFoundException extends Exception {

    private int errCode;

    public NameNotFoundException(int errCode, String message) {
        super(message);
        this.errCode = errCode;
    }

    public int getErrCode() {
        return errCode;
    }

    public void setErrCode(int errCode) {
        this.errCode = errCode;
    }
}

CustomerService.java

package com.example.examples;

import com.example.examples.exception.NameNotFoundException;

public class CustomerService {

    public Customer findByName(String name) throws NameNotFoundException {

        if ("".equals(name)) {
            throw new NameNotFoundException(666, "Name is empty!");
        }

        return new Customer(name);

    }

}