JUnit & AssertJ

📌 JUnit이란?

✅ Java 진영에서 가장 많이 사용되는 유닛 테스트 프레임워크
✅ Java 애플리케이션에서 유닛 테스트와 통합 테스트를 실행하는 데 사용

구성요소

JUnit 5는 다음 3가지 모듈로 구성된다.

모듈	설명
JUnit Platform	다양한 테스트 엔진을 실행할 수 있는 기반 제공
JUnit Jupiter	JUnit 5의 테스트 엔진 제공 (`@Test`, `@BeforeEach` 등)
JUnit Vintage	JUnit 3, 4 기반의 테스트 실행 지원

📌 JUnit 라이프사이클 어노테이션

✅ 테스트 실행 전/후 설정 및 정리를 수행하는 메서드를 정의할 수 있게 한다.

어노테이션	설명
`@BeforeEach`	각 테스트 전에 실행
`@AfterEach`	각 테스트 후에 실행
`@BeforeAll`	모든 테스트 실행 전에 1번 실행
`@AfterAll`	모든 테스트 실행 후 1번 실행

import org.junit.jupiter.api.*;

class LifecycleTest {
    
    @BeforeAll
    static void beforeAll() {
        System.out.println("📌 모든 테스트 시작 전 (1회 실행)");
    }

    @BeforeEach
    void beforeEach() {
        System.out.println("🔹 개별 테스트 실행 전");
    }

    @Test
    void test1() {
        System.out.println("✅ 실행: test1");
    }

    @Test
    void test2() {
        System.out.println("✅ 실행: test2");
    }

    @AfterEach
    void afterEach() {
        System.out.println("🔹 개별 테스트 실행 후");
    }

    @AfterAll
    static void afterAll() {
        System.out.println("📌 모든 테스트 종료 후 (1회 실행)");
    }
}

📌 JUnit 단언 (Assertions)

✅ 테스트 결과를 검증하는 다양한 Assertions를 제공
✅ 모두 org.junit.jupiter.api.Assertions 클래스의 static 메서드로 제공

메서드	설명
`assertEquals(expected, actual)`	기대값과 실제값 비교
`assertTrue(condition)`	조건이 `true`인지 확인
`assertFalse(condition)`	조건이 `false`인지 확인
`assertNotNull(object)`	객체가 `null`이 아님을 확인
`assertThrows(Exception.class, () -> {...})`	예외 발생 여부 확인

Assertions 예시

@Test  
void addAssertions() {  
    int sum = 2 + 3;  
    Assertions.assertEquals(sum, 5);  
}

예외 처리 Assertions 예제

@Test  
void exceptionAssertions() {  
    Assertions.assertThrows(ArithmeticException.class, () -> {  
        int result = 1 / 0;  
    });  
}

문제점

❌ 가독성이 떨어지는 검증
❌ 메서드 체이닝을 지원하지 않아 여러 검증을 수행하기 어려움
❌ 예외 검증이 제한적

AssertJ는 위와 같은 JUnit의 문제점을 해결한다.

📌 AssertJ란?

✅ Java에서 테스트를 작성할 때 필요한 직관적인 단언을 제공하는 라이브러리
✅ 테스트 코드의 가독성을 향상

구성요소

✅ 여러 모듈로 구성되어 있으며, 각 모듈은 특정한 타입에 대한 단언을 제공

AssertJ Core: JDK 타입(String, Iterable, Stream, Path, File, Map 등)에 대한 단언을 제공
AssertJ Guava: Guava 라이브러리의 타입(Multimap, Optional 등)에 대한 단언을 제공
AssertJ Joda-Time: Joda-Time 라이브러리의 타입(DateTime, LocalDateTime 등)에 대한 단언을 제공
AssertJ Neo4j: Neo4j 데이터베이스의 타입(Path, Node, Relationship 등)에 대한 단언을 제공
AssertJ DB: 관계형 데이터베이스의 타입(Table, Row, Column 등)에 대한 단언을 제공
AssertJ Swing: Swing 사용자 인터페이스의 기능적 테스트를 위한 API를 제공

⭐️ AssertJ Core가 가장 널리 사용되며, 나머지 모듈은 특정 환경(Guava, Joda-Time, DB 등)에서 사용됨

특징

향상된 가독성: assertThat() 메서드를 중심으로 자연스러운 언어 구조를 제공
풍부한 단언 메서드: 문자열, 컬렉션, 예외, 파일 등 다양한 타입에 대한 단언을 지원
메서드 체이닝: 여러 단언을 체이닝하여 가독성 향상
IDE 친화적: 코드 자동 완성 기능을 통해 개발 생산성을 향상

📌 AssertJ 단언 (Assertions)

기본 단언

@Test
void basicAssertions() {
    String name = "Frodo";
    assertThat(name).isEqualTo("Frodo")
                    .startsWith("Fro")
                    .endsWith("do")
                    .isEqualToIgnoringCase("frodo");
}

컬렉션 단언

@Test  
void collectionAssertions() {  
    List<String> fellowship = List.of("Frodo", "Sam", "Gandalf");  
    assertThat(fellowship).hasSize(3)  
                          .contains("Frodo", "Sam")  
                          .doesNotContain("Sauron");  
}

예외 단언

import static org.assertj.core.api.Assertions.*;

@Test  
void exceptionAssertions() {  
    assertThatThrownBy(() -> {  
        throw new Exception("boom!");  
    }).isInstanceOf(Exception.class)  
      .hasMessageContaining("boom");  
}

객체 단언

public class Member {
	Long id;
	String name;
	String nickname;
}

@Test  
void fieldsAssertions() {  
    Member member1 = new Member(1L, "choi", "phillip");  
    Member member2 = new Member(null, "choi", "phillip");  
  
    assertThat(member1).usingRecursiveComparison()  
                       .ignoringFields("id")  
                       .isEqualTo(member2);  
}

📌 JUnit과 AssertJ의 관계

JUnit은 테스트 실행을 담당 (테스트 라이프사이클 관리, @Test 제공)
AssertJ는 직관적이고 강력한 검증을 담당 (assertThat()으로 가독성 개선)
AssertJ는 JUnit이 없으면 테스트를 실행할 수 없음
JUnit만 사용하면 검증 코드가 불편하므로, AssertJ를 추가하면 가독성이 향상됨

📌 참고

https://junit.org/junit5/docs/current/user-guide
https://assertj.github.io/doc

JUnit & AssertJ

SERIES: TDD 적용을 위한 이론 정리 (6)

📌 JUnit이란?

구성요소

📌 JUnit 라이프사이클 어노테이션

📌 JUnit 단언 (Assertions)

문제점

📌 AssertJ란?

구성요소

특징

📌 AssertJ 단언 (Assertions)

기본 단언

컬렉션 단언

예외 단언

객체 단언

📌 JUnit과 AssertJ의 관계

📌 참고