JUnit5 소개

JUnit

• JUnit: 자바 개발자가 가장 많이 사용하는 Testing 기반 프레임워크
• JUnit5: JAVA8 이상부터 지원
• 테스트 작성자를 위한 API, 테스트 실행을 위한 API가 분리되어 있음
• 이전 버전인 JUnit4와 비교해서 JUnit5는 3가지 모듈로 구성되어 있음
  • JUnit Platform
    • JVM에서 테스트 프레임워크를 실행하는데 기초를 제공
    • TestEngine API를 제공해 테스트 프레임워크 개발 가능
  • JUnit Jupiter
    • TestEngine API 구현체 (JUnit5에서 제공)
    • JUnit5에서 테스트를 작성하고 확장하기 위한 새로운 프로그래밍 모델과 확장 모델의 조합
    • 테스트 코드 작성 모듈: junit-jupiter-api
    • 테스트 실행 모듈: junit-jupiter engine
  • JUnit Vintage
    • TestEngine API 구현체 (JUnit3, 4에서 제공)
    • 하위 호환성을 위해 JUnit3, JUnit4 기반으로 돌아가는 플랫폼에 테스트 엔진을 제공해줌

JUnit5 구조

위에서 소개한 3가지 모듈을 도식화하면 아래와 같은 형태로 표현된다.

JUnit5 Annotation

Annotations

Meta Annotation & Compose Annotation

JUnit Jupiter 어노테이션은 메타 어노테이션처럼 사용된다.
즉, 자동으로 메타 어노테이션을 상속하는 자신만의 컴포즈 어노테이션을 정의할 수 있다.
아래 예시를 통해 알아보자.

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Tag("fast")
@Test
public @interface FastTest{}

위와 같이 @Tag()와 @Test어노테이션을 커스텀 컴포즈 어노테이션으로 만들어 아래처럼 사용할 수 있다.

@FastTest
void fastTest(){}

Test Class, Test Method

테스트 클래스
1. 최상위 클래스, static 멤버 클래스, @Nested 클래스에 적어도 한개의 @Test어노테이션이 붙은 테스트 메소드가 포함되어 있는 클래스
2. 테스트 클래스는 abstract이면 안됨
3. 하나의 생성자가 있어야 함, 만들지 않으면 컴파일러 자동 생성

테스트 메소드
@Test, @RepeatedTest, @ParameterizedTest, @TestFactory, @TestTemplate 같은 메타 어노테이션이 붙은 메소드

라이프 사이클 메소드
@BeforeAll, @AfterAll, @BeforeEach, @AfterEach 같은 메타 어노테이션이 붙은 메소드

테스트 메소드와 라이프 사이클 메소드는 테스트할 클래스, 상속한 부모 클래스 또는 인터페이스에 선언된다.
테스트 메소드와 라이프 사이클 메소드는 abstract 선언이 없어야 하고 어떤 값도 리턴되서는 안된다.

Jupiter API : Assertions

org.junit.jupiter.api.Assertions : 값 검증을 위한 클래스, assert로 시작하는 static 메서드 제공

Junit5 Assumptions

• JUnit5에 새로 추가된 기능
• 특정 조건이 충족되는 경우에만 테스트
  • 특정 profile, OS 에서만 테스트를 실행하는 경우 활용 가능
  • assumeTrue(), assumeFalse(), assumingThat()

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotEquals;
import static org.junit.jupiter.api.Assumptions.*;

public class AssumptionTest {

    @Test
    @DisplayName("MacOs에서 실행")
    void test_Mac() {
        assumeTrue(System.getProperty("os.name").startsWith("Mac"));
        assertEquals(3, 3);
    }

    @Test
    @DisplayName("Window에서 실행")
    void test_window() {
        assumeTrue(System.getProperty("os.name").startsWith("Window"));
        assertEquals(3, 3);
    }

    @Test
    @DisplayName("조건부에서 실행")
    void test_condition() {
        String osName = System.getProperty("os.name");
        assumingThat(
                osName.startsWith("Mac"),
                () -> assertNotEquals(1, 2)
        );
        assertEquals(3, 3);
    }
}

위 예제에서는 OS에 따라 조건별로 테스트를 실행시켜보았다.
OS 뿐만 아니라 원하는 조건을 넣어 위처럼 실행시킬 수 있다.

Reference

JUnit5 기본 사용법
JUnit5 소개