# JUnit 4 vs JUnit 5 课堂演示项目

一个 Maven 项目，同时配置了 **JUnit 4.13.2**、**JUnit Jupiter 5.14.4** 和 **Vintage 引擎**，新旧两种测试可以在同一个项目里运行。

## 课前准备（一定要提前做）

1. 用 IntelliJ IDEA 打开本文件夹（File → Open，选 `junit-demo`），等它识别为 Maven 项目。
2. **联网下载依赖**：右侧 Maven 面板点刷新，或在终端运行 `mvn test`。教室网络不可靠，务必在课前完成。
3. 在终端运行一次 `mvn test`，确认看到 `BUILD SUCCESS`，并且 `Tests run` 不是 0。
4. 把下表里每个演示都在 IDEA 里点一遍，确认结果和表里一致。

## 演示对照表

| PPT 页 | 打开的类 | 怎么演示 | 应该看到 |
| --- | --- | --- | --- |
| 10 | `p10/Calc4Test` 和 `p10/Calc5Test` | 两个分别运行 | 都通过；新旧写法在同一项目共存 |
| 13 | `p13/PersonAssertAllTest` | 先运行；再把 `EXPECTED_FIRST`、`EXPECTED_LAST` 同时改错后运行 | 普通断言只报 1 个失败；assertAll 报 2 个失败 |
| 13（补充） | `p13/PersonErrorCollector4Test` | 同上 | JUnit 4 用 ErrorCollector 也能汇总失败 |
| 15 | `p15/Exception4Test` | 运行 | 两种 JUnit 4 传统写法都通过 |
| 16 | `p16/AssertThrows4Test`、`p16/AssertThrows5Test` | 先让同学猜，再运行 `AssertThrows5Test` 整个类 | 3 个通过、1 个失败（故意的）：assertThrowsExactly 不接受子类 |
| 17 | `p17/CalculatorNestedTest` | 运行整个类，展开测试结果树 | 计算器测试 → 加法 / 除法 → 具体测试 |
| 18–19 | `p19/AddParameterized4Test`、`p19/AddParameterized5Test` | 分别运行 | 每组数据显示为一条结果，如 `1 + 1 = 2` |
| 14（补充） | `p14/TimeoutAssumptionTest` | 运行 | `onlyOnCi` 显示为跳过（aborted），不是失败 |
| 20（补充） | `p20/OrganizationTest` | 运行 | 重复 5 次、动态生成 3 个、1 个被禁用 |

演示完第 13 页，记得把两个期望值改回 `"张"`、`"三"`。

## 两点说明

- **故意失败的测试**：`AssertThrows5Test.exactlyParentType_fails` 打了 `@Tag("fail-demo")`。`pom.xml` 里让 `mvn test` 跳过这个标签，所以命令行构建是绿的；在 IDEA 里运行它仍然会显示失败，正好用来演示。
- **和幻灯片的细微差别**：参数化测试里写的是 `new Calculator().add(a, b)`，幻灯片上简写成了 `Calculator.add(a, b)`；为了和第 10 页共用同一个 `Calculator` 类，这里用实例方法。

## 常用命令

```bash
mvn test                      # 运行全部测试（跳过 fail-demo）
mvn test -Dtest=Calc5Test     # 只运行某个类
mvn test -Dgroups=fast        # 只运行带 @Tag("fast") 的测试
```

## 环境要求

- JDK 8 及以上（推荐 17 或 21）
- Maven 3.6.3 及以上，或直接用 IDEA 自带的 Maven
