你是愿意在屋顶安装时发现地基有问题，还是在你还没铺第一块砖之前就发现？这就是单元测试的精髓。

  • 🐛 错误捕捉：早期发现那些恼人的错误，防止它们变成巨大的问题。
  • 🔧 无惧重构：自信地更改代码，因为你的测试为你保驾护航。
  • 💎 提升代码质量：编写更清晰、更模块化的代码，未来的你会感谢现在的自己。

当涉及到使用 Quarkus 测试微服务时？单元测试就像你的超级英雄披风。它帮助你隔离组件，确保每个微服务拼图的部分在你组装大图之前完美契合。

JUnit 5

JUnit 5不仅仅是一次升级；它是一次彻底的革新，让 Java 测试不再像是一项苦差事，而更像是一种超能力。让我们来看看一些让你的测试生活更轻松的新功能：

新功能亮点

  • @BeforeEach 和 @AfterEach：告别旧的 (@Before 和 @After)，迎接新的！这些注解让测试的设置和拆卸变得轻而易举。
  • @Nested：像专业人士一样将相关测试分组。这就像整理你的袜子抽屉，但这是为代码服务的。
  • @TestFactory：动态测试，随代码变化而成长。这是随代码演变的测试！

让我们看看一个简单的测试实例：


@Test
void additionShouldWorkLikeInElementarySchool() {
    int result = 2 + 2;
    assertEquals(4, result, "看起来数学出错了。该慌了！");
}

简单吧？但不要被它的简单性所迷惑。这个小测试在确保你的基本算术没有出错方面大有作为。

在 Quarkus 中设置测试环境

现在，让我们准备好我们的 Quarkus 项目进行一些严肃的测试。首先，我们需要邀请 JUnit 5 加入。将以下内容添加到你的pom.xml中：


<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-junit5</artifactId>
    <scope>test</scope>
</dependency>

完成这些后，让我们看看如何让 JUnit 5 和 Quarkus 和谐共处：


@QuarkusTest
public class MyAmazingServiceTest {
    @Inject
    MyAmazingService service;

    @Test
    void testServiceLogic() {
        assertTrue(service.isAwesome("Quarkus"), "我们的服务应该识别 Quarkus 的优秀！");
    }
}

@QuarkusTest注解就像一根魔杖，设置了 Quarkus 测试环境。它确保你的测试在一个迷你 Quarkus 世界中运行，配有依赖注入和所有 Quarkus 的好东西。

REST API 测试：因为 API 应该轻松运行

测试 REST API 是非常有趣的。我们将使用 RestAssured，它让 API 测试变得像散步一样轻松。这里有一个有趣的例子：


@QuarkusTest
public class SuperheroResourceTest {
    @Test
    void testGetSuperhero() {
        given()
          .when().get("/superhero/batman")
          .then()
             .statusCode(200)
             .body("name", equalTo("Bruce Wayne"))
             .body("superpower", equalTo("Being Rich"));
    }
}

这个测试检查我们的/superhero端点是否正确返回了蝙蝠侠的真实身份和超能力。记住，能力越大，测试性越强！

API 测试专业提示：

  • 测试不同的 HTTP 方法（GET、POST、PUT、DELETE）以确保全面覆盖。
  • 不要忘记测试错误场景。当有人请求一个不存在的超级英雄时会发生什么？
  • 使用参数化测试来检查多个输入，而不重复代码。

服务层测试：魔法发生的地方

服务层是大部分业务逻辑所在的地方，因此必须彻底测试。这里是 Mockito 派上用场的地方：


@QuarkusTest
public class SuperheroServiceTest {
    @InjectMock
    SuperheroRepository mockRepository;

    @Inject
    SuperheroService service;

    @Test
    void testFindSuperhero() {
        Superhero batman = new Superhero("Batman", "Being Rich");
        when(mockRepository.findByName("Batman")).thenReturn(Optional.of(batman));

        Optional<Superhero> result = service.findSuperhero("Batman");
        assertTrue(result.isPresent());
        assertEquals("Being Rich", result.get().getSuperpower());
    }
}

在这里，我们模拟了存储库以隔离我们的服务测试。这样，我们确保测试的是服务逻辑，而不是数据库交互。

避免数据库依赖

记住，单元测试应该快速且独立。避免在单元测试中访问数据库。将其留给集成测试。未来的你（以及你的 CI/CD 管道）会感谢你。

存储库测试：正确处理数据库事务

当涉及到存储库测试时，我们希望确保数据访问层正常工作，而不影响实际数据库。使用@QuarkusTestResource：


@QuarkusTest
@QuarkusTestResource(H2DatabaseTestResource.class)
public class SuperheroRepositoryTest {
    @Inject
    SuperheroRepository repository;

    @Test
    void testSaveAndRetrieveSuperhero() {
        Superhero wonderWoman = new Superhero("Wonder Woman", "Superhuman Strength");
        repository.persist(wonderWoman);

        Superhero retrieved = repository.findById(wonderWoman.getId()).orElseThrow();
        assertEquals("Wonder Woman", retrieved.getName());
        assertEquals("Superhuman Strength", retrieved.getSuperpower());
    }
}

这种设置使用内存中的 H2 数据库进行测试，确保你的测试是独立且可重复的。

最佳实践：单元测试的注意事项

要做：

  • 保持测试简短且专注。一个测试，一个断言是个不错的经验法则。
  • 使用有意义的测试名称。test1()什么也没告诉你，但testSuperheroCreationWithValidInput()却意义深远。
  • 测试边界情况。当你的方法接收到 null、空字符串或负数时会发生什么？

不要：

  • 不要测试琐碎的代码。除非包含逻辑，否则通常不需要测试 getter 和 setter。
  • 避免测试相互依赖。每个测试都应该能够独立运行。
  • 不要忽视失败的测试。失败的测试就像一个引擎故障灯——忽视它会有风险！

总结：释放单元测试的力量

好了，各位！我们已经走过了 JUnit 5 和 Quarkus 的旅程，掌握了编写测试的知识，即使是最挑剔的代码审查员也会点头称赞。记住，好的测试就像好的朋友——即使不是你想听的，它们也会告诉你真相。

通过拥抱单元测试，你不仅是在编写更好的代码；你是在构建一个安全网，让你自信地编写代码。去吧，充满热情地测试，愿你的构建永远是绿色的！

“唯一真正没有错误的代码是不存在的代码。对于其他一切，单元测试是必需的。” - 一位见多识广的匿名开发者

祝你测试愉快，愿你的代码永远没有错误！