JUnit 5 の基本アノテーションと実務テストの書き方を解説

import org.junit.jupiter.api.*;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import static org.junit.jupiter.api.Assertions.*;

class CalculatorTest {

    // テスト対象: record で不変な Calculator を定義
    record Calculator() {
        int add(int a, int b) { return a + b; }
        int subtract(int a, int b) { return a - b; }
        int multiply(int a, int b) { return a * b; }
        int divide(int a, int b) {
            if (b == 0) {
                throw new ArithmeticException("0除算はできません");
            }
            return a / b;
        }
    }

    private Calculator calc;

    @BeforeEach
    void setUp() {
        calc = new Calculator();
    }

    @Nested
    @DisplayName("加算テスト")
    class AddTests {
        @Test
        @DisplayName("正の数の加算")
        void addPositive() {
            assertEquals(8, calc.add(3, 5));
        }

        @Test
        @DisplayName("負の数を含む加算")
        void addNegative() {
            assertEquals(-2, calc.add(-5, 3));
        }

        @ParameterizedTest
        @CsvSource({ "1,2,3", "0,0,0", "-1,1,0", "100,200,300" })
        @DisplayName("様々な値の加算テスト")
        void addParameterized(int a, int b, int expected) {
            assertEquals(expected, calc.add(a, b));
        }
    }

    @Nested
    @DisplayName("除算テスト")
    class DivideTests {
        @Test
        @DisplayName("正常な除算")
        void divideNormal() {
            assertEquals(5, calc.divide(10, 2));
        }

        @Test
        @DisplayName("ゼロ除算で ArithmeticException が発生する")
        void divideByZero() {
            assertThrows(ArithmeticException.class,
                () -> calc.divide(10, 0));
        }
    }

    @Test
    @DisplayName("複数のアサーションをまとめて検証")
    void multipleAssertions() {
        assertAll("四則演算の検証",
            () -> assertEquals(8,  calc.add(3, 5)),
            () -> assertEquals(-2, calc.subtract(3, 5)),
            () -> assertEquals(15, calc.multiply(3, 5)),
            () -> assertEquals(2,  calc.divide(10, 5))
        );
    }

    @AfterEach
    void tearDown() {
        calc = null;
    }
}