SpringBoot 实战：JUnit5+MockMvc+Mockito 做好单元测试

从 SpringBoot 2.2.0 之后，Junit5 已经成为了默认的 Junit 版本。有了 JUnit Vintage，从 Junit4 迁移到 Junit5 的成本极低。所以本文就直接针对 Junit5 开始了。

版本

–

先说版本，是为了避免因为版本差异出现各种奇怪的问题：

• JDK：jdk8（小版本可以忽略）

• SpringBoot：2.5.2

• 继承spring-boot-starter-parent

• 依赖spring-boot-starter-web

• 依赖spring-boot-starter-test

• JUnit：5.7.2

• Mockito：3.9.0

• hamcrest：2.2

SpringBoot 的好处在于，只要继承spring-boot-starter-parent或引入spring-boot-dependencies，然后添加spring-boot-starter-test依赖即可。定义的 POM 内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns=“http://maven.apache.org/POM/4.0.0” xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd”>

4.0.0

org.springframework.boot

spring-boot-starter-parent

2.5.2

cn.howardliu.effective.spring

springboot-junit5-mockito

0.0.1-SNAPSHOT

springboot-junit5-mockio

org.springframework.boot

spring-boot-starter-web

org.springframework.boot

spring-boot-devtools

runtime

true

org.projectlombok

lombok

true

org.springframework.boot

spring-boot-starter-test

test

org.springframework.boot

spring-boot-maven-plugin

因为继承了spring-boot-starter-parent，所以我们依赖的spring-boot-starter-test不需要写具体的版本，可以直接集成父级的版本定义。其中，spring-boot-starter-web是用于提供 REST API 的 web 容器，spring-boot-starter-test可以提供各种测试框架的，spring-boot-maven-plugin是将 SpringBoot 应用打包为可执行 jar 的插件。

项目结构

---

因为是 DEMO 示例，我们实现一个 Echo 接口，能够接收请求参数，并返回加工后的字符串。按照惯例，我们使用万能的Hello, World!。

我们的项目结构如下：

├── pom.xml

└── src

├── main

│   ├── java

│   │   └── cn

│   │   └── howardliu

│   │   └── effective

│   │   └── spring

│   │   └── springbootjunit5mockio

│   │   ├── SpringbootJunit5MockioApplication.java

│   │   ├── controller

│   │   │   └── EchoController.java

│   │   └── service

│   │   ├── EchoService.java

│   │   └── impl

│   │   └── EchoServiceImpl.java

│   └── resources

│   └── application.yaml

└── test

└── java

└── cn

└── howardliu

└── effective

└── spring

└── springbootjunit5mockio

└── controller

├── EchoControllerMockTest.java

└── EchoControllerNoMockitoTest.java

• SpringbootJunit5MockioApplication：SpringBoot 应用启动入口

• EchoController：接口定义

• EchoService：实现业务逻辑接口

• EchoServiceImpl：接口实现

• EchoControllerMockTest：使用 Mock 代理 EchoService 实现

• EchoControllerNoMockitoTest：直接测试接口实现

EchoServiceImpl

我们看下EchoService的实现，这将是我们 DEMO 的核心实现：

@Service

public class EchoServiceImpl implements EchoService {

@Override

public String echo(String foo) {

return "Hello, " + foo;

}

}

EchoControllerNoMockitoTest

我们先使用 Junit5+MockMvc 实现 Controller 接口的普通调用，代码如下：

@SpringBootTest(classes = SpringbootJunit5MockioApplication.class)

@AutoConfigureMockMvc

class EchoControllerNoMockitoTest {

@Autowired

private MockMvc mockMvc;

@Test

void echo() throws Exception {

final String result = mockMvc.perform(

MockMvcRequestBuilders.get(“/echo/”)

.param(“name”, “看山”)

)

.andExpect(MockMvcResultMatchers.status().isOk())

.andDo(MockMvcResultHandlers.print())

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
[外链图片转存中…(img-UBHBSXFF-1715067702726)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！