<aside> 📖

학습 목표

JUnit 5의 전체 구성 요소(Jupiter, Platform, Vintage)를 구조적으로 이해합니다.
JUnit 4와 JUnit 5의 호환성과 구조 차이를 구분할 수 있습니다.
각 구성 요소의 책임과 동작 방식을 구체적으로 설명할 수 있습니다.
JUnit Platform 위에서 Jupiter와 Vintage가 어떻게 동작하는지 시각화할 수 있습니다.
실제 테스트 실행 흐름에서 JUnit 5 구조를 추적하고 활용할 수 있습니다. </aside>

1. JUnit 5 구조 개요

JUnit 5는 단일 모듈로 구성되어 있지 않고, 다음과 같은 3개의 주요 구성 요소로 나뉩니다.

JUnit Platform: 테스트 실행을 위한 런타임 환경
JUnit Jupiter: JUnit 5의 새로운 테스트 API
JUnit Vintage: JUnit 3, 4 기반의 테스트를 JUnit 5 환경에서 실행 가능하게 하는 호환 계층

JUnit 5
└── junit-platform
    ├── junit-platform-engine
    ├── junit-platform-launcher
    ├── junit-platform-console
    └── ...

JUnit Jupiter
└── junit-jupiter-api
    ├── junit-jupiter-engine
    └── junit-jupiter-params

JUnit Vintage
└── junit-vintage-engine

2. JUnit Platform

JUnit Platform은 테스트 프레임워크를 실행하기 위한 기반 런타임입니다. 즉, Jupiter든 Vintage든 모두 Platform 위에서 실행됩니다.

2-1. 주요 모듈 설명

모듈	설명
`junit-platform-engine`	Jupiter, Vintage와 같은 엔진 구현을 위한 SPI 제공
`junit-platform-launcher`	IDE, Gradle, Maven과 같은 실행기와 연결 역할
`junit-platform-console`	커맨드라인에서 JUnit 테스트 실행 가능하게 함
`junit-platform-commons`	공통 유틸리티 및 에러 처리 지원

2-2. Platform 실행 흐름 예시

LauncherDiscoveryRequest request = LauncherDiscoveryRequestBuilder.request()
    .selectors(DiscoverySelectors.selectPackage("com.example"))
    .build();

Launcher launcher = LauncherFactory.create();
launcher.execute(request);

위 코드는 테스트를 수동으로 실행할 때 Platform이 어떻게 작동하는지를 보여줍니다.

실무 팁

JUnit Platform은 Jupiter나 Vintage 외에도 다른 테스트 엔진(TestNG, Spock 등)과 연동할 수 있습니다.
Gradle 또는 Maven은 내부적으로 junit-platform-launcher를 통해 테스트를 수행합니다.