JUnit5学习之六：参数化测试(Parameterized Tests)基础

最新推荐文章于 2024-05-16 04:12:35 发布

爱学Java的程序员

最新推荐文章于 2024-05-16 04:12:35 发布

阅读量1k

点赞数 10

分类专栏：程序员文章标签：学习 sqlserver 数据库

本文链接：https://blog.csdn.net/VIP129370/article/details/137803089

版权

程序员专栏收录该内容

822 篇文章 0 订阅

订阅专栏

@DisplayName(“多个字符串型入参”)

@ParameterizedTest

@ValueSource(strings = { “a”, “b”, “c” })

void stringsTest(String candidate) {

log.info(“stringsTest [{}]”, candidate);

assertTrue(null!=candidate);

}

执行该测试类，结果如下图：

在这里插入图片描述

从上图可见执行参数化测试需要两步：首先用@ParameterizedTest取代@Test，表名此方法要执行参数化测试，然后用@ValueSource指定每次测试时的参数来自字符串类型的数组：{ “a”, “b”, “c” }，每个元素执行一次；
至此，咱们已体验过最简单的参数化测试，可见就是想办法使一个测试方法多次执行，每次都用不同的参数，接下来有关参数化测试的更多配置和规则将配合实战编码逐个展开，一起来体验吧；

版本要求

先看看SpringBoot-2.3.4.RELEASE间接依赖的junit-jupiter-5.6.2版本中，ParameterizedTest的源码，如下图红框所示，此时的ParameterizedTest还只是体验版：

在这里插入图片描述

再看看junit-jupiter-5.7.0版本的ParameterizedTest源码，此时已经是稳定版了：

在这里插入图片描述

综上所述，如果要使用参数化测试，最好是将junit-jupiter升级到5.7.0或更高版本，如果您的应用使用了SpringBoot框架，junit-jupiter是被spring-boot-starter-test间接依赖进来的，需要排除这个间接依赖，再手动依赖进来才能确保使用指定版本，在pom.xml中执行如下三步操作：

dependencyManagement节点添加junit-bom，并指定版本号：

org.junit

junit-bom

5.7.0

pom

import

排除spring-boot-starter-test和junit-jupiter的间接依赖关系：

org.springframework.boot

spring-boot-starter-test

test

org.junit.jupiter

junit-jupiter

添加junit-jupiter依赖，此时会使用dependencyManagement中指定的版本号：

org.junit.jupiter

junit-jupiter

test

如下图，刷新可见已经用上了5.7.0版本：

在这里插入图片描述

版本问题解决了，接下来正式开始学习Parameterized Tests，先要了解的是有哪些数据源；

ValueSource数据源

ValueSource是最简单常用的数据源，支持以下类型的数组：

short

byte

int

long

float

double

char

boolean

java.lang.String

java.lang.Class

下面是整形数组的演示：

@Order(2)

@DisplayName(“多个int型入参”)

@ParameterizedTest

@ValueSource(ints = { 1,2,3 })

void intsTest(int candidate) {

log.info(“ints [{}]”, candidate);

assertTrue(candidate<3);

}

从上述代码可见，入参等于3的时候assertTrue无法通过，测试方法会失败，来看看实际执行效果，如下图：

在这里插入图片描述

null、空字符串数据源

在用字符串作为入参时，通常要考虑入参为null的情况，此时ValueSource一般会这样写：

@ValueSource(strings = { null, “a”, “b”, “c” })

此时可以使用@NullSource注解来取代上面的null元素，下面这种写法和上面的效果一模一样：

@NullSource

@ValueSource(strings = { “a”, “b”, “c” })

执行结果如下图红框，可见null作为入参被执行了一次：

在这里插入图片描述

与@NullSource代表null入参类似，@EmptySource代表空字符串入参，用法和执行结果如下图所示：

在这里插入图片描述

如果想同时用null和空字符串做测试方法的入参，可以使用@NullAndEmptySource，用法和执行结果如下图所示：

在这里插入图片描述

枚举数据源(EnumSource)

EnumSource可以让一个枚举类中的全部或者部分值作为测试方法的入参；
创建枚举类Types.java，用于接下来的实战，如下，很简单只有三个值：

public enum Types {

SMALL,

BIG,

UNKNOWN

}

先尝试用Types的每个值作为入参执行测试，可见只要添加@EnumSource即可，JUnit根据测试方法的入参类型知道要使用哪个枚举：

@Order(6)

@DisplayName(“多个枚举型入参”)

@ParameterizedTest

@EnumSource

void enumSourceTest(Types type) {

log.info(“enumSourceTest [{}]”, type);

}

执行结果如下图所示：

在这里插入图片描述

如果不想执行枚举的所有值，而只要其中一部分，可以在name属性中指定：

@EnumSource(names={“SMALL”, “UNKNOWN”})

执行结果如下图所示：

在这里插入图片描述

也可以指定哪些值不被执行，此时要添加mode属性并设置为EXCLUDE（mode属性如果不写，默认值是INCLUDE，前面的例子中就是默认值）：

@EnumSource(mode= EnumSource.Mode.EXCLUDE, names={“SMALL”, “UNKNOWN”})

执行结果如下，可见SMALL和UNKNOWN都没有执行：

在这里插入图片描述

方法数据源(MethodSource)

@MethodSource可以指定一个方法名称，该方法返回的元素集合作为测试方法的入参；
先来定义一个方法，该方法一般是static类型(否则要用@TestInstance修饰)，并且返回值是Stream类型：

static Stream stringProvider() {

return Stream.of(“apple1”, “banana1”);

}

然后，测试方法用@MethodSource，并指定方法名stringProvider：

@Order(9)

@DisplayName(“静态方法返回集合，用此集合中每个元素作为入参”)

@ParameterizedTest

@MethodSource(“stringProvider”)

void methodSourceTest(String candidate) {

log.info(“methodSourceTest [{}]”, candidate);

}

上面的stringProvider方法和测试方法methodSourceTest在同一个类中，如果它们不在同一个类中，就要指定静态方法的整个package路径、类名、方法名，如下所示，类名和方法名之间用#连接：

@Order(10)

@DisplayName(“静态方法返回集合，该静态方法在另一个类中”)

@ParameterizedTest

@MethodSource(“com.bolingcavalry.parameterized.service.impl.Utils#getStringStream”)

void methodSourceFromOtherClassTest(String candidate) {

log.info(“methodSourceFromOtherClassTest [{}]”, candidate);

}

如果不在@MethodSource中指定方法名，JUnit会寻找和测试方法同名的静态方法，举例如下，静态方法methodSourceWithoutMethodNameTest会被作为测试方法的数据来源：

static Stream methodSourceWithoutMethodNameTest() {

return Stream.of(“apple3”, “banana3”);

}

@Order(11)

@DisplayName(“静态方法返回集合，不指定静态方法名，自动匹配”)

@ParameterizedTest

@MethodSource

void methodSourceWithoutMethodNameTest(String candidate) {

log.info(“methodSourceWithoutMethodNameTest [{}]”, candidate);

}

执行结果如下：

在这里插入图片描述

Csv格式数据源(CsvSource)

前面的测试方法入参都只有一个，在面对多个入参的测试方法时，@CsvSource就派上用场了，演示代码如下所示，可见数据是普通的CSV格式，每条记录有两个字段，对应测试方法的两个入参：

@Order(12)

@DisplayName(“CSV格式多条记录入参”)

@ParameterizedTest

@CsvSource({

“apple1, 11”,

“banana1, 12”,

“‘lemon1, lime1’, 0x0A”

})

void csvSourceTest(String fruit, int rank) {

log.info(“csvSourceTest, fruit [{}], rank [{}]”, fruit, rank);

}

执行结果如下，通过日志可以确定，每条记录的两个字段能匹配到测试方法的两个入参中：

在这里插入图片描述

另外@CsvSource还提供了一个属性nullValues，作用是将指定的字符串识别为null，下面这个设置就是把CSV数据中所有的NIL识别为null，再传给测试方法：

@Order(13)

@DisplayName(“CSV格式多条记录入参(识别null)”)

@ParameterizedTest

@CsvSource(value = {

“apple2, 21”,

“banana2, 22”,

“‘lemon2, lime2’, 0x0A”,

“NIL, 3” },

nullValues = “NIL”

)

void csvSourceWillNullTokenTest(String fruit, int rank) {

log.info(“csvSourceWillNullTokenTest, fruit [{}], rank [{}]”, fruit, rank);

}

执行结果如下，可见字符串NIL到测试方法后已变成null：

在这里插入图片描述

Csv文件数据源

@CsvSource解决了测试方法入参有多个字段的问题，但是把作为入参的测试数据写在源文件中似乎不合适，尤其是数据量很大的情况下，这种场景适合用@CsvFileSource，该注解用于指定csv文件作为数据源，注意numLinesToSkip属性指定跳过的行数，可以用来跳过表头：

@Order(14)

@DisplayName(“CSV文件多条记录入参”)

@ParameterizedTest

@CsvFileSource(files = “src/test/resources/two-column.csv”, numLinesToSkip = 1)

void csvFileTest(String country, int reference) {

log.info(“csvSourceTest, country [{}], reference [{}]”, country, reference);

}

在src/test/resources/创建文件two-column.csv，内容如下：

Country, reference

Sweden, 1

Poland, 2

“United States of America”, 3

上述代码执行结果如下，代码中没有测试数据，显得更加简洁一些：

在这里插入图片描述

期待《进阶》篇

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

深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

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

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！

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

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

最后

由于篇幅原因，就不多做展示了
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
课程，基本涵盖了95%以上Java开发知识点，真正体系化！**

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

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

最后

[外链图片转存中…(img-1GhRnkLp-1713208636629)]

[外链图片转存中…(img-27qRGByn-1713208636629)]

[外链图片转存中…(img-4CnXjprf-1713208636629)]

[外链图片转存中…(img-mUamhxmp-1713208636630)]

[外链图片转存中…(img-4pbWHHwE-1713208636630)]

[外链图片转存中…(img-wpVWJMFW-1713208636630)]

由于篇幅原因，就不多做展示了
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

爱学Java的程序员

关注

10
点赞
踩
23

收藏

觉得还不错? 一键收藏
0
评论
JUnit5学习之六：参数化测试(Parameterized Tests)基础

由于篇幅原因，就不多做展示了《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！课程，基本涵盖了95%以上Java开发知识点，真正体系化！**由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）[外链图片转存中…(img-1GhRnkLp-1713208636629)]
复制链接

扫一扫