JUnit - тест ожидаемых исключений

JUnit - Тест ожидаемых исключений

В JUnit есть 3 способа проверить ожидаемые исключения:

@Test, необязательный атрибут «ожидаемый»
Попробуйте поймать и всегдаfail()
@Rule ExpectedException

P.S Tested with JUnit 4.12

1. @Test ожидаемый атрибут

Используйте это, если вы хотите проверить только тип исключения, см. Ниже:

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. Попробуйте поймать и всегда терпеть неудачу ()

Это немного старая школа, широко используемая в JUnit 3. Проверьте тип исключения, а также детали исключения. См. Ниже:

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()!
Если строка, которую вы хотите протестировать, не вызвала никаких исключений, и вы забыли поставитьfail(), тест будет пройден (ложное срабатывание).

3. @Rule ExpectedException

Это правилоExpectedException (начиная с JUnit 4.7) позволяет вам проверять как тип исключения, так и детали исключения, как и метод «2. Try-catch and always fail()», но более элегантным способом:

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);

    }

}

TOC

JUnit - тест ожидаемых исключений