Junit 更多-ApiHug准备-测试篇-010

🤗 ApiHug × {Postman|Swagger|Api...} = 快↑ 准√ 省↓

GitHub - apihug/apihug.com: All abou the Apihug
apihug.com: 有爱，有温度，有质量，有信任
ApiHug - API design Copilot - IntelliJ IDEs Plugin | Marketplace

如果大家使用过testNG:

TestNG是Java中的一个测试框架，类似于JUnit 和NUnit, 功能都差不多，只是功能更加强大，使用也更方便。

一定会被 testNG(Next Generation的首字母) 里面的一些特征吸引，比如参数化，当初也是非常吸引笔者，现在Junit5中已经都有了！

不得不说 testNG，里面有很多的设计，在新一代的 Junit5 都作了参考，笔者认为，在开发人员这里Junit 使用比较广泛，在测试开发人员中 testNG 使用比较多。

第一次接触 testNG 确实也是团队中 QA 组在用这个，入坑的。

#参数

要使用 JUnit 5 进行参数化测试，除了 junit-jupiter-engine 基础依赖之外，还需要另个模块依赖：junit-jupiter-params，其主要就是提供了编写参数化测试 API。


testImplementation("org.junit.jupiter:junit-jupiter-params") {because 'junit params'
}

例子： ParameterizedUnitTestopen in new window

#基本数据源测试

基本数据源测试： @ValueSource

@ValueSource 是 JUnit 5 提供的最简单的数据参数源，支持 Java 的八大基本类型和字符串，Class，使用时赋值给注解上对应类型属性，以数组方式传递，示例代码如下：


@ParameterizedTest@ValueSource(ints = {2, 4, 8})void testNumberShouldBeEven(int num) {Assertions.assertEquals(0, num % 2);
}@ParameterizedTest
@ValueSource(strings = {"Effective Java", "Code Complete", "Clean Code"})
void testPrintTitle(String title) {System.out.println(title);
}

@ParameterizedTest 作为参数化测试的必要注解，替代了 @Test 注解。任何一个参数化测试方法都需要标记上该注解。

#CSV 数据源测试

通过 @CsvSource 可以注入指定 CSV 格式 (comma-separated-values) 的一组数据，用每个逗号分隔的值来匹配一个测试方法对应的参数，下面是使用示例：


@ParameterizedTest
@CsvSource(delimiter = ',',value = {"1,One", "2,Two", "3,Three"})
void testDataFromCsv(long id, String name) {System.out.printf("id: %d, name: %s\n", id, name);
}

可以得到结果：


id: 1, name: One
id: 2, name: Two
id: 3, name: Three

JUnit 还提供了读取外部 CSV 格式文件数据的方式作为数据源的实现，我们只要用 @CsvFileSource 指定资源文件路径即可，使用起来跟 @CsvSource 一样简单。

@CsvFileSource 指定的资源文件路径时要以 / 开始，寻找当前测试资源目录下文件


@ParameterizedTest
@CsvFileSource(resources = {"/data.csv"})
void testDataFromCsvFile(long id, String name) {System.out.printf("id: %d, name: %s", id, name);
}

文件目录：


├─java
│  └─com
│      └─dearxue
│          └─tester
│                  ParameterizedUnitTest.java
│
└─resourcesdata.csv

JUnit 还提供了以下三种数据源参考 ParameterizedUnitTestopen in new window：

@EnumSource：允许我们通过参数值，给指定 Enum 枚举类型传入，构造出枚举类型中特定的值。
@MethodSource：指定一个返回的 Stream / Array / 可迭代对象的方法作为数据源。需要注意的是该方法必须是静态的，并且不能接受任何参数。
@ArgumentSource：通过实现 ArgumentsProvider 接口的参数类来作为数据源，重写它的 provideArguments 方法可以返回自定义类型的 Stream<Arguments> ，作为测试方法所需要的数据使用。

#套件

套件 suite 是个什么？听起来像个套餐，没错他就是个套餐。

测试套件其实就是JUnit5允许我们运行多个包或者类中的测试方法，也就是分组测试。JUnit5中使用@Suite注解来声明测试套件, BTW 这个概念在testNG 也早就有了。

在开始分组测试之前，我们先了解几个注解：

@Tag：测试类和方法可以通过此注解进行标记。这些标签以后可用于过滤测试发现和执行。
@Disabled：整个测试类或单个测试方法可以通过此注解禁止测试。

还有更多的这几个：

@RunWith(JUnitPlatform.class) 执行套件
@SelectPackages({"packageA","packageB"})创建测试套件
@SelectClasses({a.class,b.class,c.class}) 创建测试套件
@IncludePackages("PackageName") 过滤需要执行的测试包
@ExcludePackages("PackageName") 过滤掉不需要执行的测试包
@IncludeClassNamePatterns 过滤需要执行的测试类
@ExcludeClassNamePatterns 过滤不需要执行的测试类
@IncludeTags("sit") 过滤需要执行的测试方法
@ExcludeTags("prod") 过滤不需要执行的测试方法

//suite we need
testImplementation 'org.junit.platform:junit-platform-suite:1.8.2'

例子在 Junit test suiteopen in new window 包含：

AssertTest
LifeCycleTests
SuiteTests

可以通过，包、类选择方式聚合成 suite, 也通过 tag 进行选择执行，这个有点类似 spring 里面 component scan, profile 设置。


// 将LifeCycleTests和AssertTest这两个类合并在一个分组中进行测试
@SelectClasses({LifeCycleTests.class, AssertTest.class})
// 也可以直接将多个包合并一个组中测试
// @SelectPackages({"com.dearxue.tester.suite"})
// 这个注解代表只测试含有DEV标签的测试类或者方法
@IncludeTags("PROD")
@Suite
@SuiteDisplayName("测试套件，分组测试")
public class SuiteTests {/*** <code>*     useJUnitPlatform {*         // includeTags 'fast'*         // excludeTags 'slow'*     }** </code>*/
}