JUnit5实战

霍格沃兹测试开发学社

ceshiren.com

大纲

• Xunit
• 基本注解
• 常用注解
• 测试方法的执行顺序
• 测试方法的参数化
• Suite套件
• TestInfo

XUnit体系结构

Junit5学习路线

Junit5 实战

• 创建maven项目

• 添加相关依赖到pom文件

• 编写相关测试用例

pom依赖

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <java.version>11</java.version>
        <!-- 使用 Java 11 语言特性 ( -source 11 ) 并且还希望编译后的类与 JVM 11 ( -target 11 )兼容，您可以添加以下两个属性，它们是默认属性插件参数的名称-->
        <maven.compiler.target>11</maven.compiler.target>
        <maven.compiler.source>11</maven.compiler.source>
        <!-- 对应junit Jupiter的版本号;放在这里就不需要在每个依赖里面写版本号，导致对应版本号会冲突-->
        <junit.jupiter.version>5.8.2</junit.jupiter.version>
        <!-- plugins -->
        <maven.compiler.version>3.8.1</maven.compiler.version>
        <maven-surefire-plugin.version>3.0.0-M5</maven-surefire-plugin.version>
        <poi.version>5.2.2</poi.version>
        <!-- 断言-->
        <hamcrest.version>2.2</hamcrest.version>
        <slf4j.version>2.0.0-alpha7</slf4j.version>
        <logback.version>1.3.0-alpha16</logback.version>
    </properties>

    <!--    物料清单 (BOM)-->
    <dependencyManagement>
        <dependencies>
            <!--当使用 Gradle 或 Maven 引用多个 JUnit 工件时，此物料清单 POM 可用于简化依赖项管理。不再需要在添加依赖时设置版本-->
            <dependency>
                <groupId>org.junit</groupId>
                <artifactId>junit-bom</artifactId>
                <version>${junit.jupiter.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

        </dependencies>
    </dependencyManagement>



    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <!--            对应添加的依赖的作用范围-->
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-suite</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
        </dependency>

        <dependency>
            <groupId>org.hamcrest</groupId>
            <artifactId>hamcrest</artifactId>
            <version>${hamcrest.version}</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.12.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>${logback.version}</version>
        </dependency>
    </dependencies>


    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>${maven-surefire-plugin.version}</version>
                <configuration>

                    <!--                    <includes>-->
                    <!--                        <include>top/testeru/group/*_Test.class</include>-->
                    <!--                    </includes>-->
                    <!--                    <excludes>-->
                    <!--                        <exclude>com/testeru/suites/cases2/*Test.class</exclude>-->
                    <!--                        <exclude>*Suite*Test</exclude>-->
                    <!--                    </excludes>-->
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.junit.jupiter</groupId>
                        <artifactId>junit-jupiter-engine</artifactId>
                        <version>${junit.jupiter.version}</version>
                    </dependency>
                    <dependency>
                        <groupId>org.junit.vintage</groupId>
                        <artifactId>junit-vintage-engine</artifactId>
                        <version>${junit.jupiter.version}</version>
                    </dependency>
                </dependencies>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>${maven.compiler.version}</version>
                <configuration>
                
                    <!-- 设置jre版本为 11 -->
                    <source>${maven.compiler.source}</source>
                    <target>${maven.compiler.target}</target>
                    <!-- 设置编码为 UTF-8 -->
                    <encoding>${maven.compiler.encoding}</encoding>
                </configuration>
            </plugin>

        </plugins>
    </build>

日志 logback.xml 配置

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- name指定<appender>的名称    class指定<appender>的全限定名  ConsoleAppender的作用是将日志输出到控制台-->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!--   写入的文件名，可以使相对目录也可以是绝对目录，如果上级目录不存在则自动创建     -->
<!--        <file>123.log</file>-->
<!--  append 为true表示日志被追加到文件结尾，如果是false表示清空文件 -->
<!--        <append>true</append>-->
<!--        encoder表示对输出格式进行格式化  FileAppender的作用是将日志写到文件中-->
        <encoder>
<!--            输出时间格式-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36}.%M\(%line\) -- %msg%n</pattern>
        </encoder>
    </appender>

    <logger name="com.ceshiren" level="DEBUG" />
    <logger name="com" level="WARN" />
    <logger name="ceshiren" level="WARN" />
    <logger name="org" level="WARN" />

    <root level="INFO">
        <appender-ref ref="STDOUT" />
    </root>

</configuration>

实战练习

• 产品：新型计算器

  • 1.多个数值连续加法运算

  • 2.两个值相减

  • 3.100连续减

  • 4.多个数值平均值

  • 5.多个字段拼接

场景需求

• 被测系统数值相关计算，传递的数据类型为：整型

• 取值范围:[-99 , 99]

• 字段拼接传入的参数必须是字符串

业务代码

public class Calculator {
    //获得具有所需名称的记录器
    static final Logger logger = getLogger(lookup().lookupClass());

    public static int result = 0;

    //用例名
    String name;
    //唯一ID标识
    String id;


    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public Calculator(String name) {
        this.name = name;
        logger.info("创建 {} ", name);
    }


    public void initId(){
        id = UUID.randomUUID().toString();
        logger.info("生成ID：{} 并绑定", id);

    }
    public void destroyId() {
        if (id == null) {
            throw new IllegalArgumentException(name + " 没有初始化对应ID");
        }
        logger.info("ID: {} 释放", id);
        id = null;
    }


    public void close() {
        logger.info("关闭 {} ", name);
    }


    //连续添加
    public int sum(int... numbers) {

        if(Arrays.stream(numbers).anyMatch(u -> u > 99) | Arrays.stream(numbers).anyMatch(u -> u < -99)){
            logger.warn("请输入范围内的整数");
            throw new IllegalArgumentException("请输入范围内的整数！");

        }else {
            return IntStream.of(numbers).sum();
        }

    }


    //从100进行减法
    public int subtract(int... numbers) {
        if(Arrays.stream(numbers).allMatch(u -> u > 99) | Arrays.stream(numbers).allMatch(u -> u < -99)){
            logger.warn("请输入范围内的整数");
            throw new IllegalArgumentException("请输入范围内的整数！");
        }else {
            return IntStream.of(numbers).reduce(100, (a, b) -> a-b);
        }
    }

    public int subtract(int x,int y) {
        if(x>99 | x<-99 | y>99 | y<-99){
            logger.warn("请输入范围内的整数");
            return 0;
        }else {
            return x-y;

        }
    }


    //平均值 average
    public double average(int... numbers) {
        if(Arrays.stream(numbers).allMatch(u -> u > 99) | Arrays.stream(numbers).allMatch(u -> u < -99)){
            logger.warn("请输入范围内的整数");
            return 0;
        }else {
            return IntStream.of(numbers).average().getAsDouble();
        }
    }


    //连续拼接
    public String concatStr(String... words) {
        return String.join(" ", words);

    }

}

实战练习

• 题目：

  • 根据需求编写对应的测试用例：加法，减法，string拼接

  • 第一步：打开计算器

  • 在每个测试方法之前生成运行的唯一ID标识

  • 在每个测试方法之前log打印：开始进行计算

  • 在测试方法得到结果后log打印：计算结果:result

  • 在每个测试方法之后进行销毁ID操作

  • 在调用完所有测试用例后执行关闭计算器app操作

实战练习

• 注意⚠️：

  • 每个测试用例都要添加断言，验证结果

  • 灵活使用测试装置

  • 边界值要进行验证

项目编写规则

• 对应前置操作放在基础BaseTest测试类中

• 对应业务逻辑测试代码在业务测试类中

运行顺序

• 如果在 业务逻辑测试类 和 Base测试类 中都有以下注解的方法，且方法名不同
  • @BeforeAll
  • @BeforeEach
  • @AfterEach
  • @AfterAll
• 对应执行顺序？？？

运行顺序

• B extends A

  • B为业务代码

  • A为BaseTest

总结知识点

• 基本的方法注解运行顺序

• 继承关系下的运行顺序

• 断言

• 异常情况断言

实战练习2

• 题目：

  • 使用参数化实现测试数据的动态传递

  • 添加自定义显示名

  • 自定义执行顺序

测试方法的执行顺序

• 配置文件声明一次，全部测试类通用

• 配置文件路径：

  • src/test/resources/junit-platform.properties

• 配置文件声明内容：

  junit.jupiter.testmethod.order.default = org.junit.jupiter.api.MethodOrderer$OrderAnnotation
  

实战练习3

• 题目：

  • 一个功能一个测试类

    • 数值相关计算的在nums包

    • 字符串相关的计算在strs包

  • 添加标签

  • 使用套件执行

    • 套件自定义显示名

TestInfo

• 有关当前测试信息注入到 以下方法中
  • @Test
  • @RepeatedTest
  • @ParameterizedTest
  • @TestFactory
  • @BeforeEach
  • @AfterEach
  • @BeforeAll
  • @AfterAll

扩展-自定义注解

• test注解+tag注解混合后自定义

总结

• 对应注解运行顺序

• 类上和方法上共同的注解

  • Displayname Tag Disable

• 参数化stream流

• 顺序执行注解order

• testInfo