java测试

August 6, 2022

单元测试

JUnit5

在这里阅读 JUnit 的指引文档
文章仅介绍了部分 API，具体参见文档

java

import static org.junit.jupiter.api.Assertions.*; // 导入Assertions类下的的所有静态方法

import java.util.*;

import org.junit.jupiter.api.Test; // Test 注解
import org.junit.jupiter.api.condition.*; // 条件相关注解
import org.junit.jupiter.params.ParameterizedTest; // 参数化测试相关
import org.junit.jupiter.params.provider.*; // 参数化测试，数据源提供相关


public class 测试文件名 {
    // 测试函数需要标注此注解
    @Test
    // 若使用 EnabledOnOs 注解，测试将只在指定平台下运行
    // 不匹配的平台，测试函数将跳过而不执行
    @EnabledOnOs(OS.WINDOWS)
    void test1() { // 函数名是任意的，应当与具体测试内容相关
        assertEquals(2, 1 + 1);
        assertTrue(1 + 1 == 2);
        assertFalse(1 + 1 != 2);
    }


    @Test
    @DisabledOnOs({OS.LINUX, OS.MAC})
    @DisabledOnJre(JRE.JAVA_8)
    // 匹配 os.arch 类型为 .*64.* （64位）
    @EnabledIfSystemProperty(named = "os.arch", matches = ".*64.*")
    // 需指定环境变量 DEBUG 为 true
    @EnabledIfEnvironmentVariable(named = "DEBUG", matches = "true")
    void test2() { // 测试类下的所有@Test标注的函数都会被调用
        assertNotNull(new Object());
        assertArrayEquals(new int[]{1, 2, 3}, new int[]{1, 2, 3});
        assertEquals(0.1, Math.abs(1 - 9 / 10.0), 0.0000001); // 比较浮点数时需指定误差值
        assertThrows(Exception.class, () -> {
            throw new Exception();
        }); // 测试异常，通过的测试在需在lambda函数抛出指定异常
    }


    // 参数化测试，测试的函数需要参数
    @ParameterizedTest
    // 指定待测参数
    @ValueSource(ints = {0, 1, 5, 100})
    void testAbs(int x) {
        assertEquals(x, Math.abs(x));
    }


    @ParameterizedTest
    @MethodSource
    void testUpperCase(String input, String result) {
        assertEquals(result, input.toUpperCase(Locale.ROOT));
    }

    // 同名静态方法将成为数据源，注意 Arguments 类，指定了输入和预期输出
    static List<Arguments> testUpperCase() {
        return List.of(Arguments.of("abc", "ABC"), Arguments.of("apple", "APPLE"), Arguments.of("good", "GOOD"));
    }


    @ParameterizedTest
    @MethodSource("testLowerCase_Source")
    void testLowerCase(String input, String result) {
        assertEquals(result, input.toLowerCase(Locale.ROOT));
    }

    // MethodSource 注解也可以指定一个函数作为数据源
    static List<Arguments> testLowerCase_Source() {
        return List.of(Arguments.of("ABC", "abc"));
    }

    // 指定CSV格式作为数据源，输入和预期输出之间用逗号分隔，逗号旁边空格为可选
    @ParameterizedTest
    @CsvSource({"ha, haha", "bye,byebye"})
    void testRepeatTwice(String input, String result) {
        assertEquals(result, input.repeat(2));
    }


    // 将CSV文件作为数据源，文件将从classpath中查找，建议置于测试源码同级目录
    @ParameterizedTest
    @CsvFileSource(resources = {"/testRepeatTwiceCSVFile.csv"})
    void testRepeatTwiceCSVFile(String input, String result) {
        assertEquals(result, input.repeat(2));
    }
    // testRepeatTwiceCSVFile.csv 内容如下（一行一组参数）：
    // ha, haha
    // bye, byebye
}

运行测试

maven 项目可以通过 mvn clean test 运行测试（注意预装的 JUnit 版本）

idea 中，可以在 File -> Project Structure 中指定一个测试文件夹，运行时将通过 JUnit 环境执行

不建议直接在命令行运行，依赖项比较多，且编译和执行都比较复杂

Fixture

测试 Fixture 可用（统一地）初始化测试环境，也可以进行清理

标注任意方法：
@BeforeEach
@AfterEach

标注静态方法：
@BeforeAll
@AfterAll

java

// 标注的函数名是任意的

@BeforeEach
void beforeEach() {
}

@BeforeAll
static void beforeAll() {
    // 必须声明为静态方法
}

集成测试

集成测试用于测试系统的各个部件是否能协同工作

←Back to home

This work is licensed under CC BY-NC-SA 4.0