JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

  1. Assertions类

  2. 按条件执行

  3. 标签(Tag)和自定义注解

  4. 参数化测试(Parameterized Tests)基础

  5. 参数化测试(Parameterized Tests)进阶

  6. 综合进阶(终篇)

本篇概览

  • 本文是《JUnit5学习》系列的第六篇,一起来实战强大参数化测试(Parameterized Tests),即多次执行同一个测试方法,每次使用不同的参数;

  • 由于参数化测试功能强大,内容也比前几篇的知识点多,为了方便大家阅读和实践,这里分为《基础》和《进阶》两篇来介绍,本篇以学习参数化测试(Parameterized Tests)的基础知识为主,包含以下内容:

  1. 极速体验;

  2. 版本依赖;

  3. ValueSource数据源

  4. null、空字符串数据源

  5. 枚举数据源

  6. 方法数据源

  7. Csv格式数据源

  8. Csv文件数据源

源码下载

  1. 如果您不想编码,可以在GitHub下载所有源码,地址和链接信息如下表所示:

| 名称 | 链接 | 备注 |

| :-- | :-- | :-- |

| 项目主页 | https://github.com/zq2599/blog_demos | 该项目在GitHub上的主页 |

| git仓库地址(https) | https://github.com/zq2599/blog_demos.git | 该项目源码的仓库地址,https协议 |

| git仓库地址(ssh) | git@github.com:zq2599/blog_demos.git | 该项目源码的仓库地址,ssh协议 |

  1. 这个git项目中有多个文件夹,本章的应用在junitpractice文件夹下,如下图红框所示:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

  1. junitpractice是父子结构的工程,本篇的代码在parameterized子工程中,如下图:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

极速体验

  1. 现在,咱们以最少的步骤体验最简单的参数化测试;

  2. 在父工程junitpractice里新建名为parameterized的子工程,pom.xml内容如下:

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns=“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 https://maven.apache.org/xsd/maven-4.0.0.xsd”>

4.0.0

com.bolingcavalry

junitpractice

1.0-SNAPSHOT

…/pom.xml

com.bolingcavalry

parameterized

0.0.1-SNAPSHOT

parameterized

Demo project for parameterized expirence in Spring Boot junit

<java.version>1.8</java.version>

org.junit

junit-bom

5.7.0

pom

import

org.springframework.boot

spring-boot-starter-web

org.projectlombok

lombok

org.springframework.boot

spring-boot-starter-test

test

org.junit.jupiter

junit-jupiter

org.junit.jupiter

junit-jupiter

test

org.springframework.boot

spring-boot-maven-plugin

  1. 新建测试类HelloTest.java,在这个位置:junitpractice\parameterized\src\test\java\com\bolingcavalry\parameterized\service\impl,内容如下:

package com.bolingcavalry.parameterized.service.impl;

import lombok.extern.slf4j.Slf4j;

import org.junit.jupiter.api.DisplayName;

import org.junit.jupiter.api.MethodOrderer;

import org.junit.jupiter.api.Order;

import org.junit.jupiter.api.TestMethodOrder;

import org.junit.jupiter.params.ParameterizedTest;

import org.junit.jupiter.params.provider.ValueSource;

import org.springframework.boot.test.context.SpringBootTest;

import static org.junit.jupiter.api.Assertions.assertTrue;

@SpringBootTest

@Slf4j

@TestMethodOrder(MethodOrderer.OrderAnnotation.class)

public class HelloTest {

@Order(1)

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

@ParameterizedTest

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

void stringsTest(String candidate) {

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

assertTrue(null!=candidate);

}

}

  1. 执行该测试类,结果如下图:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

  1. 从上图可见执行参数化测试需要两步:首先用@ParameterizedTest取代@Test,表名此方法要执行参数化测试,然后用@ValueSource指定每次测试时的参数来自字符串类型的数组:{ “a”, “b”, “c” },每个元素执行一次;

  2. 至此,咱们已体验过最简单的参数化测试,可见就是想办法使一个测试方法多次执行,每次都用不同的参数,接下来有关参数化测试的更多配置和规则将配合实战编码逐个展开,一起来体验吧;

版本要求

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

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

org.junit

junit-bom

5.7.0

pom

import

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

org.springframework.boot

spring-boot-starter-test

test

org.junit.jupiter

junit-jupiter

  1. 添加junit-jupiter依赖,此时会使用dependencyManagement中指定的版本号:

org.junit.jupiter

junit-jupiter

test

  1. 如下图,刷新可见已经用上了5.7.0版本:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

ValueSource数据源

  1. ValueSource是最简单常用的数据源,支持以下类型的数组:

short

byte

int

long

float

double

char

boolean

java.lang.String

java.lang.Class

  1. 下面是整形数组的演示:

@Order(2)

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

@ParameterizedTest

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

void intsTest(int candidate) {

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

assertTrue(candidate<3);

}

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

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

null、空字符串数据源

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

《一线大厂Java面试题解析+后端开发学习笔记+最新架构讲解视频+实战项目源码讲义》

【docs.qq.com/doc/DSmxTbFJ1cmN1R2dB】 完整内容开源分享

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

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

@NullSource

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

  1. 执行结果如下图红框,可见null作为入参被执行了一次:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

枚举数据源(EnumSource)

  1. EnumSource可以让一个枚举类中的全部或者部分值作为测试方法的入参;

  2. 创建枚举类Types.java,用于接下来的实战,如下,很简单只有三个值:

public enum Types {

SMALL,

BIG,

UNKNOWN

}

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

@Order(6)

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

@ParameterizedTest

@EnumSource

void enumSourceTest(Types type) {

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

}

  1. 执行结果如下图所示:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

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

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

  1. 执行结果如下图所示:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

  1. 也可以指定哪些值不被执行,此时要添加mode属性并设置为EXCLUDE(mode属性如果不写,默认值是INCLUDE,前面的例子中就是默认值):

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

  1. 执行结果如下,可见SMALL和UNKNOWN都没有执行:

JUnit5学习之六:参数化测试(Parameterized Tests)基础,java架构师的简历模板

方法数据源(MethodSource)

  1. @MethodSource可以指定一个方法名称,该方法返回的元素集合作为测试方法的入参;
上一篇:20min速成的柯学 - [油管1080P可达]


下一篇:Spring boot 配置单元测试