JUnit 5 源码结构概览

JUnit 5 的源码分为三大核心模块：JUnit Platform、JUnit Jupiter 和 JUnit Vintage。每个模块职责明确，共同构建了现代化的测试框架。以下是详细的源码结构解析：

一、JUnit Platform

定位：测试框架的运行时基础设施，提供跨引擎的统一 API，支持 IDE 和构建工具集成。
源码目录：junit-platform/
核心子模块：

junit-platform-commons
- 功能：提供通用工具类和基础注解，供其他模块共享。
- 关键类/接口：
  - org.junit.platform.commons.support：反射工具类（如 AnnotationSupport）。
  - org.junit.platform.commons.annotation：基础注解（如 Testable）。
junit-platform-engine
- 功能：定义测试引擎的核心 API 和默认实现。
- 关键类/接口：
  - TestEngine：测试引擎接口（如 JupiterTestEngine 实现）。
  - TestDescriptor：描述测试结构（类、方法、动态测试）。
  - EngineExecutionListener：监听测试执行事件（开始、结束、失败）。
junit-platform-launcher
- 功能：提供测试启动 API，供 IDE 和构建工具（如 Maven、Gradle）调用。
- 关键类/接口：
  - Launcher：测试启动入口。
  - LauncherDiscoveryRequest：定义测试发现规则（如包过滤、标签筛选）。

二、JUnit Jupiter

定位：新一代编程模型，支持 JUnit 5 的新特性（如 @Test、@ParameterizedTest）。
源码目录：junit-jupiter/
核心子模块：

junit-jupiter-api
- 功能：定义 JUnit Jupiter 的注解和断言接口。
- 关键类/接口：
  - org.junit.jupiter.api：核心注解（@Test、@BeforeEach）。
  - org.junit.jupiter.api.Assertions：断言方法（assertEquals、assertThrows）。
junit-jupiter-engine
- 功能：实现 Jupiter 测试引擎，处理注解并执行测试。
- 关键类/接口：
  - JupiterTestEngine：Jupiter 的 TestEngine 实现。
  - JupiterExecutionContext：管理测试执行上下文（如扩展注册）。
junit-jupiter-params
- 功能：支持参数化测试（@ParameterizedTest）。
- 关键类/接口：
  - ParameterizedTestExtension：处理参数化测试逻辑。
  - ArgumentsProvider：参数提供器接口（如 CsvFileSource 的实现）。

三、JUnit Vintage

定位：兼容 JUnit 3/4 的测试引擎，允许旧版本测试在新框架中运行。
源码目录：junit-vintage/
核心子模块：

junit-vintage-engine
- 功能：将 JUnit 4 的 Runner 转换为 JUnit 5 的 TestEngine。
- 关键类/接口：
  - VintageTestEngine：兼容 JUnit 4 的引擎实现。
  - JUnit4TestAdapter：适配 JUnit 4 的 TestCase 和 TestSuite。

四、源码目录结构示例

junit5/
├── junit-platform/             # 平台模块
│   ├── junit-platform-commons  # 通用工具
│   ├── junit-platform-engine   # 测试引擎核心
│   └── junit-platform-launcher # 启动器
│
├── junit-jupiter/              # Jupiter 模块
│   ├── junit-jupiter-api       # 注解与断言 API
│   ├── junit-jupiter-engine    # 引擎实现
│   └── junit-jupiter-params    # 参数化测试支持
│
└── junit-vintage/              # Vintage 模块└── junit-vintage-engine    # JUnit 4 兼容引擎

五、关键设计模式

策略模式
- TestEngine 接口允许不同引擎（Jupiter、Vintage）灵活切换。
观察者模式
- TestExecutionListener 监听测试事件（如 testStarted、testFinished）。
扩展机制
- 通过 Extension 接口（如 BeforeEachCallback）实现功能扩展。

六、学习建议

从 Jupiter 入手：先理解 @Test 方法从扫描到执行的完整流程（JupiterTestEngine）。
调试核心流程：
- 跟踪 Launcher 启动测试的链路。
- 分析 TestDescriptor 如何构建测试树（类 → 方法 → 动态测试）。
对比 Vintage：查看 VintageTestEngine 如何将 JUnit 4 的 Runner 转换为 TestDescriptor。