Spring Boot 2 教程：WebFlux 集成测试及部署（十）

作者：程序员泥瓦匠

2021 年 12 月 15 日
本文字数：2349 字
阅读完需：约 8 分钟

WebFlux 集成测试及部署

前言

在日常工作中，免不了自测 UT，因为覆盖率不达标，是不允许提交测试，那怎么进行 WebFlux 项目的测试呢。@WebFluxTest 是 WebFlux 测试的重要注解。

结构

回到这个工程中，使用 springboot-webflux-3-mongodb 工程，工程如图：

目录核心如下：

pom.xml 添加 Test 相关依赖；
test / CityWebFluxControllerTest WebFlux API 测试类；

代码 GiHub 详见这里。

POM 依赖

pom.xml 添加对应的测试依赖：

    <!-- Spring Boot Test 依赖 -->    <dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-test</artifactId>      <scope>test</scope>    </dependency>
    <dependency>      <groupId>io.projectreactor</groupId>      <artifactId>reactor-test</artifactId>      <scope>test</scope>    </dependency>

复制代码

CityWebFluxControllerTest WebFlux API 测试类

@WebFluxTest 用于测试 Spring WebFlux 控制器，支持自动配置 Spring WebFlux 基础组件，可以限制扫描范围等。

代码如下：

@RunWith(SpringRunner.class)@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)public class CityWebFluxControllerTest {
    @Autowired    private WebTestClient webClient;
    private static Map<String, City> cityMap = new HashMap<>();
    @BeforeClass    public static void setup() throws Exception {        City wl = new City();        wl.setId(1L);        wl.setProvinceId(2L);        wl.setCityName("WL");        wl.setDescription("WL IS GOOD");        cityMap.put("WL", wl);    }
    @Test    public void testSave() throws Exception {
        City expectCity = webClient.post().uri("/city")                .contentType(MediaType.APPLICATION_JSON)                .body(BodyInserters.fromObject(cityMap.get("WL")))                .exchange()                .expectStatus().isOk()                .expectBody(City.class).returnResult().getResponseBody();
        Assert.assertNotNull(expectCity);        Assert.assertEquals(expectCity.getId(), cityMap.get("WL").getId());        Assert.assertEquals(expectCity.getCityName(), cityMap.get("WL").getCityName());    }
}

复制代码

代码详解：

@WebFluxTest 注入了 WebTestClient 对象，用于测试 WebFlux 控制器，好处是快速，并无需启动完整 HTTP 容器。
WebTestClient.post() 方法构造了 POST 测试请求，并使用 uri 指定路由。
expectStatus() 用于验证返回状态是否为 ok()，即 200 返回码。
expectBody(City.class) 用于验证返回对象体是为 City 对象，并利用 returnResult 获取对象。
Assert 是以前我们常用的断言方法验证测试结果。

运行 Test，得到如图验证结果：

工程运行方式

了解工程服务器部署，先了解工程如何运行。

上面使用应用启动类运行工程，这是其中一种工程运行方式。Spring Boot 应用的运行方式很简单，下面介绍下这三种运行方式。

1. 使用应用启动类

在 IDEA 中直接执行应用启动类，来运行 Spring Boot 应用，日常开发中，会经常使用这种方式启动应用。常用的会有 Debug 启动模式，方便在开发中进行代码调试和 bug 处理。自然，Debug 启动模式会比正常模式稍微慢一些。

2. 使用 Maven 运行

通过 Maven 运行，需要配置 Spring Boot Maven 插件，在 pom.xml 配置文件中，新增 build 节点并配置插件 spring-boot-maven-plugin，代码如下：

<build>    <plugins>        <!-- Spring Boot Maven 插件 -->        <plugin>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-maven-plugin</artifactId>        </plugin>    </plugins></build>

复制代码

在工程根目录中，运行如下 Maven 命令来运行 Spring Boot 应用：

mvn spring-boot:run

复制代码

实际调用的是 pom.xml 配置的 Spring Boot Maven 插件 spring-boot-maven-plugin，上面执行了插件提供的 run 指令。也可以在 IDEA 右侧工具栏的 Maven Project Tab 中，找到 Maven 插件的 spring-boot-maven-plugin，执行相应的指令。所有指令如下：

# 生成构建信息文件spring-boot:build-info# 帮助信息spring-boot:help# 重新打包spring-boot:repackage# 运行工程spring-boot:run# 将工程集成到集成测试阶段，进行工程的声明周期管理spring-boot:startspring-boot:stop

复制代码

3. 使用 Java 命令运行

使用 Maven 或者 Gradle 安装工程，生成可执行的工程 jar 后，运行如下 Java 命令来运行 Spring Boot 应用：

java -jar target/xxx.jar

复制代码

这里运行了 spring-boot-maven-plugin 插件编译出来的可执行 jar 文件。通过上述三种方式都可以成功运行 Spring Boot 工程，成功运行输出的控制台信息如图 1-10 所示。

工程服务器部署

基础环境安装如上面说的，需要 JDK 环境、Maven 环境等。

Win 服务器

推荐使用 AlwaysUp：

使用方式也很简单：

Linux 服务器

推荐 yum 安装基础环境，比如安装 JDK：

yum -y list java*yum -y install java-1.8.0-openjdk*java -version

复制代码

安装 Maven：

yum -y list apache-mavensudo wget http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo -O /etc/yum.repos.d/epel-apache-maven.reposudo yum install -y apache-mavenmvn --v

复制代码

Linux 使用 nohup 命令进行对后台程序的启动关闭。

关闭应用的脚本：stop.sh

启动应用的脚本：start.sh

重启应用的脚本：stop.sh

总结

这一篇主要一起实践了简单的 WebFlux API 控制层的测试，Service 测试 Mock 和以前一样，以及工程运行、服务器部署的操作。

发布于: 4 小时前阅读数: 6

程序员泥瓦匠

关注

还未添加个人签名 2018.10.29 加入

我是泥瓦匠，公号「程序员泥瓦匠」。一枚技术程序员草根，坚持分享编程，算法，Java 等干货教程和代码案例。打算起手不凡写出鸿篇巨作的人，往往坚持不了完成第一章节。

发布

暂无评论

创作场景

Spring Boot 2 教程：WebFlux 集成测试及部署（十）

WebFlux 集成测试及部署

前言

结构

POM 依赖

CityWebFluxControllerTest WebFlux API 测试类

工程运行方式

1. 使用应用启动类

2. 使用 Maven 运行

3. 使用 Java 命令运行

工程服务器部署

Win 服务器

Linux 服务器

总结

程序员泥瓦匠

评论