>> 欢迎您 客人: 登录 | 注册 | 在线 | 搜索 | 风格 | 帮助 | 统计 | 文章 返回首页
>>分享流行的Java框架以及开源软件,对孙卫琴的《精通Spring:Java Web开发技术详解》提供技术支持 书籍支持  卫琴直播  品书摘要  在线测试  资源下载  联系我们
Java技术网站 → 『 Java开发技术 』 → 『 Spring框架和各种开源软件技术专题 』 → Spring Boot 基于 JUnit 5 实现单元测试
发表一个新主题 开启一个新投票 回复文章 您是本文章第 19196 个阅读者 刷新本主题
 * 贴子主题:  Spring Boot 基于 JUnit 5 实现单元测试 回复文章 点赞(0)  收藏  
作者:javathinker    发表时间：2020-07-13 07:43:00     消息  查看  搜索  好友  复制  引用
      本文介绍 Spring Boot 2 基于 JUnit 5 的单元测试实现方案。    

目录

  • 简介
  • JUnit 4 和 JUnit 5 的差异
    1. 忽略测试用例执行
    2.   RunWith 配置
    3.   @Before、 @BeforeClass、 @After、 @AfterClass 被替换
  • 开发环境
  • 示例

简介

Spring Boot 2.2.0 版本开始引入 JUnit 5 作为单元测试默认库，在 Spring Boot 2.2.0 版本之前， spring-boot-starter-test 包含了 JUnit 4 的依赖，Spring Boot 2.2.0 版本之后替换成了 Junit Jupiter。    

JUnit 4 和 JUnit 5 的差异

1. 忽略测试用例执行
JUnit 4：    

@Test
@Ignore
public void testMethod() {
   // ...
}

  JUnit 5：    

@Test
@Disabled("explanation")
public void testMethod() {
   // ...
}

2.  RunWith 配置
JUnit 4：    

@RunWith(SpringRunner.class)
@SpringBootTest
public class ApplicationTests {
    @Test
    public void contextLoads() {
    }
}

  JUnit 5：    

@ExtendWith(SpringExtension.class)
@SpringBootTest
public class ApplicationTests {
    @Test
    public void contextLoads() {
    }
}

3.  @Before、 @BeforeClass、 @After、 @AfterClass 被替换
  •   @BeforeEach 替换  @Before
  •   @BeforeAll 替换  @BeforeClass
  •   @AfterEach 替换  @After
  •   @AfterAll 替换  @AfterClass

开发环境

  • JDK 8

示例

  1.   创建 Spring Boot 工程，参考：IntelliJ IDEA 创建 Spring Boot 工程。
  2.   添加  spring-boot-starter-web 依赖，最终  pom.xml 如下。
<?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">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.6.RELEASE</version>
        <relativePath/>
    </parent>
    <groupId>tutorial.spring.boot</groupId>
    <artifactId>spring-boot-junit5</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>spring-boot-junit5</name>
    <description>Demo project for Spring Boot Unit Test with JUnit 5</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

  1. 工程创建好之后自动生成了一个测试类。
package tutorial.spring.boot.junit5;

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class SpringBootJunit5ApplicationTests {

    @Test
    void contextLoads() {
    }

}

  这个测试类的作用是检查应用程序上下文是否可正常启动。 @SpringBootTest 注解告诉 Spring Boot 查找带  @SpringBootApplication 注解的主配置类，并使用该类启动 Spring 应用程序上下文。
  1. 补充待测试应用逻辑代码
4.1. 定义 Service 层接口    

package tutorial.spring.boot.junit5.service;

public interface HelloService {

    String hello(String name);
}

  4.2. 定义 Controller 层    

package tutorial.spring.boot.junit5.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import tutorial.spring.boot.junit5.service.HelloService;

@RestController
public class HelloController {

    private final HelloService helloService;

    public HelloController(HelloService helloService) {
        this.helloService = helloService;
    }

    @GetMapping("/hello/{name}")
    public String hello(@PathVariable("name") String name) {
        return helloService.hello(name);
    }
}

  4.3. 定义 Service 层实现    

package tutorial.spring.boot.junit5.service.impl;

import org.springframework.stereotype.Service;
import tutorial.spring.boot.junit5.service.HelloService;

@Service
public class HelloServiceImpl implements HelloService {

    @Override
    public String hello(String name) {
        return "Hello, " + name;
    }
}

  1. 编写发送 HTTP 请求的单元测试。
package tutorial.spring.boot.junit5;

import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.client.TestRestTemplate;
import org.springframework.boot.web.server.LocalServerPort;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class HttpRequestTest {

    @LocalServerPort
    private int port;

    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    public void testHello() {
        String requestResult = this.restTemplate.getForObject("http://127.0.0.1:" + port + "/hello/spring",
                String.class);
        Assertions.assertThat(requestResult).contains("Hello, spring");
    }
}

  说明：
  • webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT

    使用本地的一个随机端口启动服务；
  •   @LocalServerPort 相当于  @Value("${local.server.port}")；
  • 在配置了  webEnvironment 后，Spring Boot 会自动提供一个  TestRestTemplate 实例，可用于发送 HTTP 请求。
  • 除了使用  TestRestTemplate 实例发送 HTTP 请求外，还可以借助  org.springframework.test.web.servlet.MockMvc 完成类似功能，代码如下：
package tutorial.spring.boot.junit5.controller;

import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.test.web.servlet.result.MockMvcResultHandlers;
import org.springframework.test.web.servlet.result.MockMvcResultMatchers;

@SpringBootTest
@AutoConfigureMockMvc
public class HelloControllerTest {

    @Autowired
    private HelloController helloController;

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testNotNull() {
        Assertions.assertThat(helloController).isNotNull();
    }

    @Test
    public void testHello() throws Exception {
        this.mockMvc.perform(MockMvcRequestBuilders.get("/hello/spring"))
                .andDo(MockMvcResultHandlers.print())
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andExpect(MockMvcResultMatchers.content().string("Hello, spring"));
    }
}

  以上测试方法属于整体测试，即将应用上下文全都启动起来，还有一种分层测试方法，譬如仅测试 Controller 层。
  1. 分层测试。
package tutorial.spring.boot.junit5.controller;

import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.test.web.servlet.result.MockMvcResultHandlers;
import org.springframework.test.web.servlet.result.MockMvcResultMatchers;
import tutorial.spring.boot.junit5.service.HelloService;

@WebMvcTest
public class HelloControllerTest {

    @Autowired
    private HelloController helloController;

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private HelloService helloService;

    @Test
    public void testNotNull() {
        Assertions.assertThat(helloController).isNotNull();
    }

    @Test
    public void testHello() throws Exception {
        Mockito.when(helloService.hello(Mockito.anyString())).thenReturn("Mock hello");
        this.mockMvc.perform(MockMvcRequestBuilders.get("/hello/spring"))
                .andDo(MockMvcResultHandlers.print())
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andExpect(MockMvcResultMatchers.content().string("Mock hello"));
    }
}

  说明：
  •   @WebMvcTest 注释告诉 Spring Boot 仅实例化 Controller 层，而不去实例化整体上下文，还可以进一步指定仅实例化 Controller 层的某个实例： @WebMvcTest(HelloController.class)；
  • 因为只实例化了 Controller 层，所以依赖的 Service 层实例需要通过  @MockBean 创建，并通过  Mockito 的方法指定 Mock 出来的 Service 层实例在特定情况下方法调用时的返回结果。
----------------------------
原文链接:https://www.jianshu.com/p/4648fd55830e

程序猿的技术大观园：www.javathinker.net



[这个贴子最后由 flybird 在 2020-10-23 09:27:17 重新编辑]
Java精品书籍推荐
Java最新视频教程推荐
  Java面向对象编程-->图形用户界面（下）
  JavaWeb开发-->访问数据库(Ⅰ)
  JSP与Hibernate开发-->通过JPA API检索数据
  Java网络编程-->Socket用法详解
  精通Spring-->Vue组件开发高级技术
  Vue3开发-->绑定表单
本站其他相关文章
  Maven 镜像地址大全
  Marshalling在Netty中的使用
  VSCode插件的高级用法
  卫琴姐姐制作的最新视频课程：基于Spring的JavaWeb开发技术详...
  WebFlux 响应式编程初体验
  Spring AOP的基本概念和注解
  拦截器不拦截静态资源的三种处理方法
  解析配置文件 redis.conf、Redis持久化RDB、Redis的主从复制
  Spring Cloud 技术栈及架构一览
  一文详解微服务架构(好文值得细读)
  如何实现Git服务间同步
  Spring+JPA+ehcache开启二级本地缓存
  带你逆袭kafka之路
  酒店评论数据分析和挖掘-展现数据分析全流程：报告展示篇
  大话微服务」深入聊聊SpringCloud之客户端负载均衡机制
  更多...
 IPIP: 已设置保密
树形列表:   
共1页 0条记录 当前第1页
发表一个新主题 开启一个新投票 回复文章

中文版权所有： JavaThinker技术网站 Copyright 2016-2026 沪ICP备16029593号-2
荟萃Java程序员智慧的结晶，分享交流Java前沿技术。  联系我们
如有技术文章涉及侵权，请与本站管理员联系。