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

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

1. GitHub - apihug/apihug.com: All abou the Apihug   
2. apihug.com: 有爱，有温度，有质量，有信任
3. 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
│
└─resources
        data.csv

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

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

#套件

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

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

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

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

还有更多的这几个：

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

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

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

1. AssertTest
2. LifeCycleTests
3. 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>
   */
}

#参考

1. testNGopen in new window
2. JUnit 5 Test Suites

我们