SpringCloud2023实战之接口服务测试工具SpringBootTest

你好，这里是专栏“SpringCloud2023实战”。

点击查看专栏SpringCloud实战

往期推荐：

• SpringCloud和SpringBoot的版本依赖该怎么选择
• SpringCloud2023最新版本该如何进行组件选型？
• 如何简洁高效的搭建一个SpringCloud2023的maven工程
• 如何在SpringCloud2023中快速集成注册中心
• 如何在SpringCloud2023中快速集成配置中心
• 在SpringCloud2023中快速集成SpringCloudGateway网关
• 使用Sentinel进行服务调用的熔断和限流管理
• SpringCloud2023中使用Seata解决分布式事务

前言

Spring Boot Test 是 Spring Boot 生态系统中的一部分，它基于 Spring Test 和 JUnit 等其他测试框架，提供了便捷高效的测试手段。Spring Boot Test 进行了再次封装，增加了切片测试，并增强了 mock 能力。

SpringBootTest是Spring Framework提供的用于编写集成测试的工具类，它可以帮助开发人员轻松地编写自动化的集成测试用例，以验证整个Spring应用程序上下文的行为。SpringBootTest可以加载完整的应用程序上下文，并支持对各个组件进行集成测试，包括控制器、服务、存储库、数据库访问等。

• 加载应用程序上下文：SpringBootTest能够加载整个Spring应用程序上下文，包括所有的bean定义、配置文件、组件扫描等。这使得测试用例能够在一个真实的Spring环境中执行，而不需要手动模拟或配置大量的依赖项。
• 自动配置：通过使用SpringBootTest注解，开发人员可以自动配置所需的环境，例如内嵌的数据库、自定义的Bean等。这样可以减少测试用例中的重复代码，提高测试的可维护性。
• 模拟环境：除了加载完整的应用程序上下文外，SpringBootTest还提供了一些模拟环境的功能，比如可以使用@MockBean来替换某些bean的实际实现，以便更好地控制测试环境。
• 自动化测试：SpringBootTest支持JUnit或者TestNG等测试框架，可以方便地编写各种类型的自动化测试用例，包括单元测试、集成测试、端到端测试等。
• 与Spring Boot集成：SpringBootTest天然与Spring Boot集成，可以很容易地对Spring Boot应用程序进行集成测试。

SpringBootTest同时集成了JUnit Jupiter、AssertJ、Hamcrest测试辅助库，使得更容易编写但愿测试代码。

核心组件如下：

• JUnit 5：Java应用程序单元测试的事实标准。
• Spring Test和Spring Boot Test：为Spring Boot应用程序提供实用工具和集成测试支持。
• AssertJ：一个流畅的断言库。
• Hamcrest：一个匹配器对象库（也称为约束或谓词）。
• Mockito：一个Java模拟框架。
• JSONassert：一个针对JSON的断言库。
• JsonPath：JSON的XPath解析库。

SpringBootTest应用集成

引入pom.xml

• 引入SpringBootTest主要是引入 spring-boot-starter-test。

<?xml version="1.0" encoding="UTF-8"?><projectxmlns="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 http://maven.apache.org/xsd/maven-4.0.0.xsd"><parent><groupId>io.rainforest</groupId><artifactId>banana</artifactId><version>1.0</version></parent><modelVersion>4.0.0</modelVersion><artifactId>banana-client6-test</artifactId><description>spring cloud banana-client6-test</description><packaging>jar</packaging><dependencies><!-- 核心依赖省略 --><!--测试依赖--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><!--测试依赖-便于测试webflux相关的接口--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-webflux</artifactId></dependency></dependencies></project>

修改配置

• 无特殊修改。

spring.application.name: banana-client5-tracing
server:port:10120servlet:context-path: /app

修改启动类

• 启动类不需要特殊修改。

packageio.rainforest.banana.app;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.cloud.client.discovery.EnableDiscoveryClient;importorg.springframework.cloud.openfeign.EnableFeignClients;@SpringBootApplication@EnableDiscoveryClient@EnableFeignClientspublicclassApplication{publicstaticvoidmain(String[] args){SpringApplication.run(Application.class, args);}}

接口demo

• 通过访问 http://localhost:10120/ 测试接口。

packageio.rainforest.banana.app.web.demo;importlombok.extern.slf4j.Slf4j;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.ResponseBody;importorg.springframework.web.bind.annotation.RestController;importjava.util.ArrayList;importjava.util.List;@RestController@Slf4jpublicclassHelloWorld{@GetMapping("/")publicStringhello(String hello){
        log.info("this is a test");return"Hello World";}}

SpringBootTest测试用例编写

Spring Boot应用程序是一个Spring ApplicationContext，因此除了使用Spring context进行测试之外，不需要做任何特别的事情。Spring Boot 提供了一个 @SpringBootTest 注解，当需要 Spring Boot 功能时，它可以作为标准 spring-test @ContextConfiguration 注解的替代。该注解通过 SpringApplication 在测试中创建 ApplicationContext 来工作。除了 @SpringBootTest，还提供了许多其他注解来测试应用程序的更具体部分。

默认情况下，@SpringBootTest不会启动服务器。您可以使用@SpringBootTest的webEnvironment属性来进一步定义测试运行的方式：

• MOCK(默认值)：加载一个Web应用程序上下文并提供模拟的Web环境。在使用此注解时，嵌入式服务器不会启动。如果您的类路径上没有Web环境，则此模式会自动回退到创建常规的非Web应用程序上下文。它可以与@AutoConfigureMockMvc或@AutoConfigureWebTestClient一起使用，用于对您的Web应用程序进行基于模拟的测试。
• RANDOM_PORT：加载一个WebServer应用程序上下文并提供真实的Web环境。嵌入式服务器会启动并侦听一个随机端口。
• DEFINED_PORT：加载一个WebServer应用程序上下文并提供真实的Web环境。嵌入式服务器会启动并侦听一个已定义的端口（来自您的application.properties文件）或默认端口8080。
• NONE：通过使用SpringApplication加载一个应用程序上下文，但不提供任何Web环境（模拟或其他方式）。

带启动参数的单元测试

通过args属性可以指定启动参数。

packageio.rainforest.banana.app;importorg.junit.jupiter.api.Test;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.boot.ApplicationArguments;importorg.springframework.boot.test.context.SpringBootTest;importstaticorg.assertj.core.api.Assertions.assertThat;@SpringBootTest(args ="--app.test=one")classMyApplicationArgumentTests{@TestvoidapplicationArgumentsPopulated(@AutowiredApplicationArguments args){assertThat(args.getOptionNames()).containsOnly("app.test");assertThat(args.getOptionValues("app.test")).containsOnly("one");}}

带mock环境的单元测试

通过mockmvc可以发起rest请求测试本地接口。

packageio.rainforest.banana.app;importorg.junit.jupiter.api.Test;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;importorg.springframework.boot.test.context.SpringBootTest;importorg.springframework.test.web.reactive.server.WebTestClient;importorg.springframework.test.web.servlet.MockMvc;importstaticorg.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;importstaticorg.springframework.test.web.servlet.result.MockMvcResultMatchers.content;importstaticorg.springframework.test.web.servlet.result.MockMvcResultMatchers.status;@SpringBootTest@AutoConfigureMockMvcclassMyMockMvcTests{@TestvoidtestWithMockMvc(@AutowiredMockMvc mvc)throwsException{
        mvc.perform(get("/")).andExpect(status().isOk()).andExpect(content().string("Hello World"));}// If Spring WebFlux is on the classpath, you can drive MVC tests with a WebTestClient@TestvoidtestWithWebTestClient(@AutowiredWebTestClient webClient){
            webClient
                    .get().uri("/").exchange().expectStatus().isOk().expectBody(String.class).isEqualTo("Hello World");}}

带运行服务的单元测试

带完整的springboot运行环境的单元测试。

packageio.rainforest.banana.app;importorg.junit.jupiter.api.Test;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.boot.test.context.SpringBootTest;importorg.springframework.boot.test.context.SpringBootTest.WebEnvironment;importorg.springframework.test.web.reactive.server.WebTestClient;@SpringBootTest(webEnvironment =WebEnvironment.RANDOM_PORT)classMyRandomPortWebTestClientTests{@TestvoidexampleTest(@AutowiredWebTestClient webClient){
        webClient
            .get().uri("/").exchange().expectStatus().isOk().expectBody(String.class).isEqualTo("Hello World");}}

其它的单元测试

SpringBootTest提供了很多集成的starter测试工具类。例如：

• Spring GraphQL Tests
• Data Cassandra Tests
• Data Couchbase Tests

具体内容可以查看SpringBoot的文档了解。

关于作者

来自全栈程序员nine的探索与实践，持续迭代中。（工作卫星codetrend）